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PLEXUS INTRODUCTION 





This release of the Plexus Sys3 UNIX Programmer's Manual is designed for use with Plexus 
Sys3. This manual includes a number of commands that are not part of stock SYSTEM III, plus 
enhancements to SYSTEM Ill commands. The majority of these are in Section 1 ("Commands 
and Application Programs"). Therefore, Volume 1 was separated into two different physical 
volumes. Section 1 is now in physical Volume 1A, and Sections 2 through 8 are in Volume 1B. 


Some SYSTEM Ill commands are designed for use with UNIX systems on specific hardware 
such as the PDP-11; these commands are inappropriate for use on Plexus systems, and are 
thus not supported by Plexus. No source was provided for other SYSTEM III commands. The 
following table lists all the SYSTEM III commands that are not supported by Plexus, along with 
codes indicating why Plexus does not support them. The codes have the following meanings: 








NA - Applicable to other hardware. 
NI - Not implemented. 
NS - No source available. 


ae 


Command Function Code 
as.pdp assembler for PDP-11 NA 
as.vax assembler for VAX-11/780 NA 
chess the game of chess NS 
dj DJ-11 asynchronous multiplexor NA 
dmc communications link with built-in DDCMP NA 
protocol 
dn DN-11 ACU interface NA 
dpr off-line print NA 
dqs DQS-11 interface for two-point BSC NA 
du DU-11 synchronous line interface NA 
dz DZ-11, OZ-11/KMC-11, DH-11 asynchronous NA 
multiplexors 
etp Equipment Test Package NA 
fget retrieve files from the HONEYWELL 6000 NA 
fget.demon file retrieval daemons NA 
fptrap floating point interpreter NA 
fsev convert files between PDP-11 and NA 
VAX-11/780 systems 
fsend send files to the HONEYWELL 6000 NA 
gcat send phototypesetter output to the NA 
HONEYWELL 6000 
gcosmail send mail to HIS user NA 
gdev graphical device routines and filters NI 
ged graphical editor NI 
gps format of graphical files NI 
graphics access graphical and numerical commands NI 
gutil graphical utilities NI 
hasp RJE (Remote Job Entry) to IBM NA 
hp RPO4/RP05/RP06 moving-head disk NA 
hs RH11/RJS03-RJS04 fixed-head disk file NA 
ht TU16 magnetic tape interface NA 
kas assembler for the KMC11 microprocessor NA 
kl KL-11 or DL-11 asynchronous interface NA 


kmc 
kun 


maze 
pel 
reversi 
rf 

rk 

ri 


rp 

sdb 
sky 

st 

stat 

tm 

toc 
vaxops 
vix 


KMC11 microprocessor 

un-assembler for the KMC11/DMC11 
microprocessor 

generate a maze 

parallel communications link interface 

a game of dramatic reversals 

RF11/RS11 fixed-head disk file 

RK-11/RKO3 or RKO5 disk 

RL-11/RLO1 disk 

RP-11/RP03 moving-head disk 

symbolic debugger 

obtain ephemerides 

synchronous terminal interface 

statistical network for graphical commands 

T™M11/TU10 magnetic tape interface 

graphical table of contents routines 

VAX-11/780 console operations 

VAX-11/780 LSI console floppy interface 


See the Introductions to each section for information on new commands. 




















BELL INTRODUCTION 


(This Introduction was written by Bell Laboratories for the UNIX User's Manual Release 7.0.) 


This manual describes the features of UNIX. It provides neither a general overview of UNIX (for 
that, see “The UNIX Time-Sharing System,” BSTJ, Vol. 57, No. 6, Part 2, pp. 1905-29, by 
D. M. Ritchie and K. Thompson), nor details of the implementation of the system (see “UNIX 
Implementation,” BSTJ, same issue, pp. 1931-46). 


Not all commands, features, and facilities described in this manual are available in every UNIX 
system; for example, yacc(1) is usually not available in a UNIX system running on a PDP-11/23. 
When in doubt, consult your system's administrator. 


This manual is divided into eight sections, some containing inter-filed sub-classes: 


1. Commands and Application Programs: 
1. General-Purpose Commands. 
1C. Communications Commands. 
1G. Graphics Commands. 
1M. System Maintenance Commands. 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines. 

3M. Mathematical Library Routines. 

3S. Standard I/O Library Routines. 
3X. Miscellaneous Routines. 

Special Files. 

. File Formats. 

. Games. 

. Miscellaneous Facilities. 

. System Maintenance Procedures. 


ONOaS 


Section 1 (Commands and Application Programs) describes programs intended to be invoked 
directly by the user or by command language procedures, as opposed to subroutines, which are 
intended to be called by the user's programs. Commands generally reside in the directory /bin 
(for binary programs). Some programs also reside in /usr/bin, to save space in /bin. These 
directories are searched automatically by the command interpreter called the shel/. Sub-class 
1C contains communication programs such as cu, dpr, etc. These entries may differ from 
system to system. Sub-class 1M contains system maintenance programs such as fsck, mktfs, 
etc., which generally reside in the directory /ete; these commands are not intended for use by 
the ordinary user due to their privileged nature. Some UNIX systems have a directory called 
/ust/Ibin, containing local commands. 


Section 2 (System Calls) describes the entries into the UNIX supervisor, including the C 
language interface. 


Section 3 (Subroutines) describes the available subroutines. Their binary versions reside in 
various system libraries in the directories /lib and /usr/lib. See intro(3) for descriptions of these 
libraries and the files in which they are stored. 


Section 4 (Special Files) discusses the characteristics of each system file that actually refers to 
an input/output device. The names in this section generally refer to the Digital Equipment 
Corporation's device names for the hardware, rather than to the names of the special files 
themselves. 


Section 5 (File Formats) documents the structure of particular kinds of files; for example, the 
format of the output of the link editor is given in a.out(5). Excluded are files used by only one 
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command (for example, the assembler’s intermediate files). In general, the C language struct 
declarations corresponding to these formats can be found in the directories /usr/include and 
/usr/include/sys. 


Section 6 (Games) describes the games and educational programs that, as a rule, reside in the 
directory /usr/games. 


Section 7 (Miscellaneous Facilities) contains a variety of things. Included are descriptions of 
character sets, macro packages, etc. 


Section 8 (System Maintenance Procedures) discusses crash recovery and boot procedures, 
etc. Information in this section is not of great interest to most users. 


Each section consists of a number of independent entries of a page or so each. The name of 
the entry appears in the upper corners of its pages. Entries within each section are 
alphabetized, with the exception of the introductory entry that begins each section. The page 
numbers of each entry start at 1. Some entries may describe several routines, commands, etc. 
In such cases, the entry appears only once, alphabetized under its “major” name. 


All entries are based on a common format, not all of whose parts always appear: 
The NAME part gives the name(s) of the entry and briefly states its purpose. 


The SYNOPSIS part summarizes the use of the program being described. A few 
conventions are used, particularly in Section 1 (Commands): 


Boldface strings are literals and are to be typed just as they appear. 


Italic strings usually represent substitutable argument prototypes and program names 
found elsewhere in the manual (they are underlined in the typed version of the entries). 


Square brackets [] around an argument prototype indicate that the argument is 
optional. When an argument prototype is given as “name” or “file”, it always refers to 
a file name. | 


Ellipses ... are used to show that the previous argument prototype may be repeated. 


A final convention is used by the commands themselves. An argument beginning with 
a minus —, plus +, or equal sign = is often taken to be some sort of flag argument, 
even if it appears in a position where a file name could appear. Therefore, it is unwise 
to have files whose names begin with —, +, or =. 


The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 
The FILES part gives the file names that are built into the program. 
The SEE ALSO part gives pointers to related information. 


The DIAGNOSTICS part discusses the diagnostic indications that may be produced. 
Messages that are intended to be self-explanatory are not listed. 


The WARNINGS part points out potential pitfalls. 


The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the suggested 
fix is also described. 


A table of contents and a permuted index derived from that table precede Section 1. On each 
index line, the title of the entry to which that line refers is followed by the appropriate section 
number in parentheses. This is important because there is considerable duplication of names 
among the sections, arising principally from commands that exist only to exercise a particular 
system call. On most systems, all entries are available on-line via the man(1) command, q.v. 
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HOW TO GET STARTED 


This discussion provides the basic information you need to get started on UNIX: how to log in 
and log out, how to communicate through your terminal, and how to run a program. (See UNIX 
for Beginners by B. W. Kernighan for a more complete introduction to the system.) 


Logging in. You must dial up UNIX from an appropriate terminal. UNIX supports full-duplex 
ASCII terminals. You must also have a valid user name, which may be obtained (together with 
the telephone number(s) of your UNIX system) from the administrator of your system. Common 
terminal speeds are 10, 15, 30, and 120 characters per second (110, 150, 300, and 1,200 baud); 
occasionally, speeds of 240, 480, and 960 characters per second (2,400, 4,800, and 9,600 
baud) are also available. On some UNIX systems, there are separate telephone numbers for 
each available terminal speed, while on other systems several speeds may be served by a 
single telephone number. In the latter case, there is one “preferred” speed; if you dial in from a 
terminal set to a different speed, you will be greeted by a string of meaningless characters (the 
login: message at the wrong speed). Keep hitting the “break” or “attention” key until the login: 
message appears. Hard-wired terminals usually are set to the correct speed. 


Most terminals have a speed switch that should be set to the appropriate speed and a half-/full- 
duplex switch that should be set to full-duplex. When a connection (at the speed of the 
terminal) has been established, the system types login: and you then type your user name 
followed by the “return” key. If you have a password (and you should!), the system asks for it, 
but does not print (“echo”) it on the terminal. After you have logged in, the “return”, “new-line”, 
and “line-feed” keys will give exactly the same result. 


It is important that you type your login name in lower case if possible; if you type upper-case 
letters, UNIX will assume that your terminal cannot generate lower-case letters and that you 
mean all subsequent upper-case input to be treated as lower case. When you have logged in 
successfully, the shell will type a $ to you. (The shell is described below under How to run a 
program. ) 


For more information, consult login(1) and getty(8), which discuss the login sequence in more 
detail, and stty(1), which tells you how to describe the characteristics of your terminal to the 
system (profile(5) explains how to accomplish this last task automatically every time you log in). 


Logging out. There are two ways to log out: 


1. You can simply hang up the phone. 

2. You can log out by typing an end-of-file indication (ASCIl EOT character, usually typed 
as “control-d") to the shell. The shell will terminate and the login: message will appear 
again. 


How to communicate through your terminal. When you type to UNIX, a gnome deep in the 
system is gathering your characters and saving them. These characters will not be given to a 
program until you type a “return” (or “new-line’), as described above in Logging in. 


UNIX terminal input/output is full-duplex. It has full read-ahead, which means that you can type 
at any time, even while a program is typing at you. Of course, if you type during output, the 
output will have interspersed in it the input characters. However, whatever you type will be 
saved and interpreted in the correct sequence. There is a limit to the amount of read-ahead, 
but it is generous and not likely to be exceeded unless the system is in trouble. When the 
read-ahead limit is exceeded, the system throws away ai! the saved characters. 


On an input line from a terminal, the character @ “kills” all the characters typed before it. The 
character # erases the last character typed. Successive uses of # will erase characters back 
to, but not beyond, the beginning of the line; @ and # can be typed as themselves by preceding 
them with \ (thus, to erase a \, you need two #s). These default erase and kill characters can 
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be changed; see sity(1). 


The ASCII DC3 (control-s) character can be used to temporarily stop output. It is useful with CRT 
terminals to prevent output from disappearing before it can be read. Output is resumed when a 
DC1 (control-q) or a second DC3 (or any other character, for that matter) is typed. The DC1 an 
DC3 characters are not passed to any other program when used in this manner. 


The ASCll DEL (a.k.a. “rubout”) character is not passed to programs, but instead generates an 
interrupt signal, just like the “break”, “interrupt”, or “attention” signal. This signal generally 
causes whatever program you are running to terminate. It is typically used to stop a long 
printout that you don’t want. However, programs can arrange either to ignore this signal 
altogether, or to be notified when it happens (instead of being terminated). The editor ed(1), for 
example, catches interrupts and stops what it is doing, instead of terminating, so that an 
interrupt can be used to halt an editor printout without losing the file being edited. 


The quit signal is generated by typing the ASCII FS character. It not only causes a running 
program to terminate, but also generates a file with the “core image” of the terminated process. 
Quit is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent as to whether you have 
a terminal with the “new-line” function, or whether it must be simulated with a “carriage-return” 
and “line-feed” pair. in the latter case, all input “carriage-return” characters are changed to 
“line-feed” characters (the standard line delimiter), and a “carriage-return” and “line-feed” pair 
is echoed to the terminal. If you get into the wrong mode, the stty(1) command will rescue you. 


Tab characters are used freely in UNIX source programs. If your terminal does not have the tab 
function, you can arrange to have tab characters changed into spaces during output, and 
echoed as spaces during input. Again, the stty(1) command will set or reset this mode. The 
system assumes that tabs are set every eight character positions. The tabs(1) command will 
set tab stops on your terminal, if that is possible. 


How to run a program. When you have successfully logged into UNIX, a program called the 
shell is listening to your terminal. The shell reads the lines you type, splits them into a 
command name and its arguments, and executes the command. A command is simply an 
executable program. Normally, the shell looks first in your current directory (see The current 
directory below) for a program with the given name, and if none is there, then in system 
directories. There is nothing special about system-provided commands except that they are 
kept in directories where the shell can find them. You can also keep commands in your own 
directories and arrange for the shell to find them there. 


The command name is the first word on an input line to the shell; the command and its 
arguments are separated from one another by space and/or tab characters. 


When a program terminates, the shell will ordinarily regain control and type a $ at you to 
indicate that it is ready for another command. The shell has many other capabilities, which are 
described in detail in sh(1). 


The current directory. UNIX has a file system arranged in a hierarchy of directories. When the 
system administrator gave you a user name, he or she also created a directory for you 
(ordinarily with the same name as your user name, and known as your login or home directory). 
When you fog in, that directory becomes your current or working directory, and any file name 
you type is by default assumed to be in that directory. Because you are the owner of this 
directory, you have full permissions to read, write, alter, or destroy its contents. Permissions to 
have your will with other directories and files will have been granted or denied to you by their 
respective owners, or by the system administrator. To change the current directory use cd(1). 
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Path names. To refer to files not in the current directory, you must use a path name. Full path 
names begin with /, which is the name of the root directory of the whole file system. After the 
slash comes the name of each directory containing the next sub-directory (followed by a /), until 
finally the file name is reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is 
itself a subdirectory of usr; usr springs directly from the root directory). See intro(2) for a 
formal definition of path name. 


lf your current directory contains subdirectories, the path names of files therein begin with the 
name of the corresponding subdirectory (without a prefixed /). Without important exception, a 
path name may be used anywhere a file name is required. - 


Important commands that modify the contents of files are cp(1), mv(1), and rm(1), which 
respectively copy, move (i.e., rename), and remove files. To find out the status of files or 
directories, use /s(1). Use mkdir(1) for making directories and rmdir(1) for destroying them. 


For a fuller discussion of the file system, see the references cited at the beginning of the 
INTRODUCTION above. It may also be useful to glance through Section 2 of this manual, which 
discusses system calls, even if you don't intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use ed(1). The four 
principal languages available under UNIX are C (see cc(1)), Fortran (see f77(1)), bs (a 
compiler/interpreter in the spirit of Basic, see bs(1)), and assembly language (see as(1)). After 
the program text has been entered with the editor and written into a file (whose name has the 
appropriate suffix), you can give the name of that file to the appropriate language processor as 
an argument. Normally, the output of the language processor will be left in a file in the current 
directory named a.out (if that output is precious, use mv(1) to give it a less vulnerable name). If 
the program is written in assembly language, you will probably need to load with it library 
subroutines (see /d(1)). Fortran and C call the loader automatically; programs written in bs(1) 
are interpreted and, therefore, do not need to be loaded. 


When you have finally gone through this entire process without provoking any diagnostics, the 
resulting program can be run by giving its name to the shell in response to the $ prompt. 


If any execution (run-time) errors occur, you will need adb(1) to examine the remains of your 
program. 


Your programs can receive arguments from the command line just as system programs do; see 
exec(2). 


Text processing. Almost all text is entered through the editor ed(1). The commands most 
often used to write text on a terminal are cat(1), pr(1), and nroff(1). The cat(1) command 
simply dumps ASCII text on the terminal, with no processing at all. The pr(1) command 
paginates the text, supplies headings, and has a facility for multi-column output. Nroff(1) is an 
elaborate text formatting program, and requires careful forethought in entering both the text and 
the formatting commands into the input file; it produces output on a typewriter-like terminal. 
Troff(1) is very similar to nroff(1), but produces its output on a phototypesetter (it was used to 
typeset this manual). There are several “macro” packages (especially the so-called mm 
package) that significantly ease the effort required to use nroff(1) and troff(1); Section 7 entries 
for these packages indicate where you can find their detailed descriptions. 


Surprises. Certain commands provide inter-user communication. Even if you do not plan to 
use them, it would be well to learn something about them, because someone else may airn them 
at you. To communicate with another user currently logged in, write(1) is used; maif(1) will 
leave a message whose presence will be announced to another user when he or she next logs 
in. The corresponding entries in this manual also suggest how to respond to these two 
commands if you are their target. 
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When you log in, a message-of-the-day may greet you before the first $. 
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UL © | ene rere ry Een nene meee rer oer dh lousabsveslavedencaeedevaceosies process a report of logged errors 
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NC DCUID oe iciics sn snssccsacanesecccos saz oasavernseemeines: take a core image of the ICP and transfer to a host file 
1 sec ytueecte coche sce tecatsacmaanaaueieaceuncs sae macs aces kine teteee ses seattee uae print user and group IDs and names 
WSCA once cceseeiese cn etecectieaabetecctascedeuaseneskansy ter wasshieivunadconvavsuncncs <cuwawieuueensaus egeceaseet install commands 
NOY cst oa saeaaescas cake veers iat eteceeteeieezee in aa eens ees relational database operator 





March 1984 -2- Plexus Sys3 UNIX 


Contents 











BAD Y ccc ccs e es ecine do raenccenamenesaecasanceeet tas anise ecs ise aancanean anes aceeesoumaea aueuna eratieonedes terminate a process 
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VPI SON visio sescocnitalivsevsdecdadeixenthnnedenecioen ence getriernautdagincssyes load the KMC11-B; print VPM traces 
WE ia diets ecesec oa nestaentcen ge aDanueaatawes se sseaice enue cela bssaeeeseeaselawelboesabiaeese await completion of process 
WN ssa teed netroas to aiesceancetecdes tats Je aneseeneatas tut osc duioulesocten auaazcueowasnc ueenaerackscoteeeee eee write to all users 
WG asiseete capetsdues varies Vas cnneaietecesaeucuameuguus wanna ass casuuuauovactibasuatevaetegansiesdadiesteesdeadectaivostoamaues word count 
ENE occ se cadena et sh case ee ewe eatae ees a vaca do ss vance aden eaanee tenet eee: identify SCCS files 
WIN aac emi sircias taser cases eae needa a as soa aes aeons who is on the system 
WN OC iso etssdicshicepoe dete au cewem nas dbvctes aconeaa saa tune aegrenaeaseaieuwads ialehe econ sameness who is doing what 
WETS iiss adres ieee ons acetate netend oweetins Voudoadseunebasnaueninesvesamangeacaceuieeceuiweae write to another user 
MOUOS oer ei caein cee caine construct argument list(s) and execute command 
MUU seater ates Soacanceiemsexs cans encacovaccundsnacseushancecaueeucsenieescouaencauneiessteae cross reference for C programs 
MUR sss ces sdesaceesveccesevesnespe tuwneetesatetessts extract strings from C programs to implement shared strings 
VCC sinasiscsdisiwscscca dash tewteceaciinaaaweieiwicavetaucsicadh taste veut oenees aeoee yet another compiler-compiler 





MINEO sci sacsesieecsteceseass SagasigeaaieacncanacsuxGeeaedtenesadseutes! introduction to system calls and error numbers 
COCO SS iscsi aan aioe one Fa ns senate sauishecessnaesaebdealsateaneaieaents determine accessibility of a file 
CCU ac css asa ceucanewecstadcpsmeagaciane atest ceweuecandeciei hse hieeieeaadouseaceetien: enable or disable process accounting 
NMED sess ie ceca ig aece Ge cancuseviacassten sucess sacuaiaeeweesnes Maem ia eee set a process's alarm clock 
MOEN oases eciiesin sec occa aru vous Gesedag eG tadetcecteas cotaencebenieetene ies change data segment space allocation 
CONCH oa Soins sons Fees wsnsscuacgcaancapededeaiyes vac deewasosea oe tedaenven ices tacecaseeasaeusasanieeee change working directory 
ONO ose cess cts os ease cassie Associa pceacatumoesinaneacsseas Pecasessannadeaseeaewustieartemeeees change mode of file 
CON OW IN a sic tescnnch stensd eve Sutwceweansien Giacastueneed ex ehwevsani ddestaee cesavi ocemaeeses change owner and group of a file 
MIMO esa Seale aad aa saree os Nec sesagicauseaca tata snansda ali auaea sede Weedenduaas oseieseoseuniaces change root directory 
COSC si iisicesct uecspate ae cace ais sage cccasehageaceesccunceui ants achnceneserted eect eee close a file descriptor 
CUODE ssccic ce siecarccctscivartvecwunsisacesiavaianeiseleodee aneomareatealine: create a new file or rewrite an existing one 
UN iss ss sates aint tated osc wcece vases ove uaws sorasessacadauestoseedeuuadeseswauee: duplicate an open file descriptor 
OKC oie aaase hateaw ie ceneelcsiaeic sagan ctnoualendieenaanet ces tees eave nataniareseeseee ys eae execute a file 
NN cae cateatns es emcees ties tienen acca esac as atone saauvnanteiesessanee canes terminate process 
MOUNT pedis caes tec Oscoda sions aah siat nhl ehocaa ice ache cadees taeeets ana saeees cas seeisan voted aeeaavaeuuateccactecdusneaeas file control 
NOU oceans cs ices ch pate ae sac eoanteesatoraccteuncetenadacdoyssenesieseaaastand cocan ceed neccent inst roeivaens create a new process 
COUN sass sec creas stsentinesccicnscess seecaacondetezcxeaes get process, process group, and parent process IDs 
GQQtUIG  sicscsnienansisceiesiumtaen .-get real user, effective user, real group, and effective group IDs 
NOG esis cviscernes bt copnatesdenestsautebcaars seestaaesssitcigeossevastonsesyauenie daueebee couse tectcasecoeviean conten ae control device 
MUU 2c Saacuiceadavseuesieweseettewencatewesecienusseteeneetiaaietiac send a signal to a process or a group of processes 
MING scacestece ction eccecatdetoeleace sea aewin ab se, ccetdstenticateteudceeb code ceae aasoueecak wassuee us tadadanessaseeeestades: link to a file 
NOOK oc sscsataceusaneesuadousnunsaosseccsetntecs Weiis satientdioassaut vaassectiedavevenceuus cece sieeosviauieeat lock a process in memory 
MOCKING ois eschscciic ted eateidicie eine aieastantenseem: provide exclusive file regions for reading or writing 
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IS@QK.............ccccecccescccnsccccsnsecccssceccnsseccseseccceessesenenscccoessscceenseesonenenenans move read/write file pointer 
ITIKTIOG............cccccsscccseccsssccesscccnscecceesesessceeesenseassesenss make a directory, or a special or ordinary file 
IMOUNE.. .............cccecccccccessccesccresscccescecssccccsstscascesseesccesccaeoeseeunsseeesereescaseseneeoesees mount a file system 
TICE oo... ccc ccccceecccesccccccccccsccccscccesscccecccssecesscccsssssescnssconsesesceeeseseseeeoncees change priority of a process 
ODOM 00.0... cece eceeesseseereeeeeeessccsssesseeusesnscneneeeensssuseseenscssscacseessenssecuesesosseoneds open for reading or writing 
DAUSG. 0... eee cccccecccceseeeeeesscessecscescceseccsanscsacensnscenecceeeeserseeessuseooens .....suspend process until signal 
DIYS... eee ecceseecessnsecessssnssscccnscscsacseneeeeeaeanensens allow a process to access physical memory 
DIPO..............cccccssssceceeecceeeeeetecstccsscsssseeseesccessseeseeeeeneeeeeaeneeseneseeeeeens create an interprocess channel 
DPOF il ........... eee ee eesessecsecsscccesssnsescccsncscnccceeeesesseeeseeseeeeeseseesseetssscsceoeoeersessseeees execution time profile 
PUPAE 0... eee cc eeseeecnceeeceeeeessssceeeecncessccenseesesnsceeseecenssssaaeeasecesesaeoeeseesseessescesssesenseeeaaes process trace 
FOB. 2... eccceccccccssscccsscccssccescccusccceseeeceanceceesceeassesecessscscesceeecouesceseuasseescceeceeseseneeeesaessens read from file 
FIMOUNT 0.0... ccc csccceccecccecccseccesscnsscascccacccseccoescceescseecessoseeeees mount a remote file system directory 
FUITIOUNNL.............cccsecccecccesccssccesscenssesesesccessenssecseesscsescosseoesees umount a remote file system directory 
SOTPGOPP. .............cescccccececscsesesceeececseecuensecsssssssessensescsesseesauaueaererseaseesesseuasseneeees set process group ID 
SOCUI 20.2... oo. e ce eccescescesccnscssccsececcssessscesccnsccesseessoseuecnseccsecosscscsescceseecaseees set user and group IDs 
SIGMA... ccccceecccetecceeeeeeeeeeessssssessssstesessesreeesesrenes specify what to do upon receipt of a signal 
Statt..........scccccsscccssecsscesseecessesccssescesesccoeesscscessnecesees besecenceecesecccascesssccccassesescscsesececeses get file status 
SUING 020... cccecceccteccencceeccenccneccanseancensssesescossscesseesconsccseccessccsesoneeeaconsensassescoesseesseeeeee reas set time 
SYNC... eee cccccessssesscessncccceceeeesenssesccsscaceaaceesssesscensaesasessesnesseeceeeeeseeneeeeeeseseeeenenees update super-block 
SYSCa 00... ccccccccsctsssssssscscneeccceceeescessessscssenssennsesssseeeeccncceeeseeesseeeeeeoneees numeric id of system call 
PHIM ...........00.cccccccecccsscccosccsscecsveccecscasscccesccssscceescesssssecsesussccessecoaeceesesesssessseseeseresesscossseceeses get time 
THMOS....0...........ccccssscceevecsceccccccccssseccaseescesssscessscecasessscssecssesoens get process and child process times 
UGQTOW ........csesssscescesssseccsseecececseeeecceeecceseceesusssssscceseuseuseeesccesecesecceseeseooones change system stack limit 
UliMIt.............cccccescececececcesececcnsncensceeeseescaees susuaeseceeeesceeeccecceeeeceeeeecssaeaaaaeassees get and set user limits 
UNMASK. ............ccccccccssecccsssccscnsesccsessscecaeseccccessessesesesecccessecssoeseesseonesees set and get file creation mask 
UMOUN................ccccccssccessccescccsseceenccesccnscccessseessecesesensssonsssonssssessceeseeeseseoons unmount a file system 
UMAIMG 2.0... cecccccsssseeccesnsecsccssssescesecsesscecasasseesasessonsesesecaceseceeeeues get name of current UNIX system 
UNIIK ...........cccssseccccssseccnsscscceecnaessesensnsessescescoeuassceeccaecsecesencecesesesecsesssaseeese remove directory entry 
UStat .............ccccssccccssseccssseccecsssecccneesescnessssseccasssecenssssonsessseccesscecoeesesesceees get file system statistics 
UTIIMG ...... ec. secceessccscccasecccssssecesssecessecesssescancssessesseeeenecoeeses set file access and modification times 
WAIT 00... cece cecesccccsssecccessecccensccecessesoeesssesanssssersconsssssecoees wait for child process to stop or terminate 
WIIC.............ccccnsscccesccnsscccestcccssseccesesensssseasesecsnssseoessssonsessnesscsueseesenssceseceeseneceseesonseeses write on a file 





HNRIO. noe. cccccccecensssssscesscecesssssaceseeecsscsceeeessscecesceeesseeeess introduction to subroutines and libraries 
BGAN... cccssreecsscssstecsesscnscscesesseseensesseeesssceeeaseeeeeenses convert between long and base-64 ASCII 
ADOT... essssseecceecesseceseeescaaessessceceecesesseuesasseeeescccucesssseeseessacecsssceoueusres generate an /OT fault 
ADS .........ccsecccssscccsssccsscccnsecesssssccansesscssssecssesscasssscasssecassscceesscsceseseesseeeseoeseeess integer absolute value 
1-1) | ere sedceeeneaensccasscccessccescesesseneseoeseee program verification 
ALOP .............cccccccccccccssssssceeeececcecccecceeacssssssssssessessassseeeeecseccacscacacesssseseeees convert ASCII to numbers 
DOSS ............ccccccsscsssccsntcceecccsneccssecnesecceeeescnseesacsecacsecasesoaesseaessesseceasessccessoeseeseseees bessel functions 
DSCAMECH .............cccccssseccssssscecccsssceccesserscaescseedcceesscscaesssseeessscecnesseeseascsensssenssesenessesesene binary search 
CONV .......cccccssscccsssccnscccsscccasscccasscsceeseccesecencesnscsanssscussessensescasscesessesoessoesceesesoes character translation 
et] °) eee DES encryption 
CROP IMI ....... eee ccc cecenceecseteeccersnsenesencesceescesceenccsscescessceeecessescseaeres generate file name for terminal 
CRIA .... eee cece teeeencccceeesssseccccecccneaesssseeeeeecceccecorsuesseeecesereassseeecescas convert date and time to ASCII 
CEY PO o.oo. eee ccccssssscecessssseccenensscseeerccceseceesescsenesecesecoaescesssedassseesecesseeensonses character classification 
CUPSES 00.0... ccc seccsscssccsccssccsccsscessccessasesesceessoesssonssesseusees screen 1 functions with optimal cursor motion 
CUSCSIG ........... ccc cccceeccsseccesscecesccsssecnecscuseccesansceuesssaseseeseeeaeesousees character login name of the user 
QCOVE .... cc ecccccssccencneeescensccessecececeececesscecenseccessecesssoeseccesessencesescecessseseeeacacesoneees output conversion . 
ONG .0.......cccccccssccccesscceassccensencceceesssecaasseeeecessacessescueeseecaussecesseesesceceseesoseeess last locations in program 
OXP 20... .ccccsescccssccecsseccecseccnscccesecccsseeeesseeseeeens exponential, logarithm, power, square root functions 
FONOSG 1.2.0.0... ec ceeecccsseccescccceescecnescscncsscescnsseeessasseecesscccuessscesssscecseseessscoscsouses close or flush a stream 
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POPE ON siisdsccasecseeasisiecadeents 
ribet saeseseasessssscsnsssararsesansesesesssssasatsescorscseneceseessccesseeees SUEAM status inquines 
aaa Tei ALaae absolute value, floor, ceiling, remainder functions 
eee ean ....open a stream 
i sahara taeipiatnnneiinieinninenianecetentanna buffered binary input/output 
eee ee nena rete ete ee split into mantissa and exponent 
ee reposition a stream 
Se sesteseeneeeeaees log gamma function 
TARAS OT TION get character or word from stream 
et aking sane aninnk: seco! value for environment name 
getlogin Se rere ee er get group file entry 
ee ee Poe’ et login name 
EEE MOEN get option letter from argv 
ee read a password 
ee get name from UID 
ae get password file entry 
Se TET EAE AEN get a string from a stream 
ae aie NLL IRREES CNC sieseensees Euclidean distance 
ibavene Sekai ea caannncnai hic convert between 3-byte integers and long integers 
ea iad sassesenensesesensenenenneneneneccncensnsatansceeseensseneasacesacecanensesss ee login name of user 
oc a ecb In RCL BL inet linear search and update 
Li Ch AO Sicha elinenadia alias” main memory allocator 
sae GG Tad CLG make a unique file name 
17 ae sac Na SLU CIR AU prepare execution profile 
staan es Manan aa get entries from name list 
AA eM EO: ‘System error messages 
STRATA SERENE: graphics interface subroutines 
AAMT TAREE initiate 1/O to/from a process 
ee beens in eno si begciena acing 9 Oo ee output formatters 
eS aR ANE NE NOOR put character or word on a stream 
ee write password file entry 
Se ee Satna nee rete eee era put a string on a stream 
1 gn aL RIERA AMR ADCS Wesictivaterahadeveccsttet quicker sort 
ee random number generator 
ec as a ets as a cag regular expression compile/execute 
sce AI NE a ee ee formatted input conversion 
sctinic snlipia umiaasn aetna ee assign buffering to a stream 
aca a in a naa ag eddeeduaconeeng! oe non-local goto 
en ee eee ner ee hyperbolic functions 
ee eee suspend execution for interval 
Ce ee sS oftware signals 
aa aerate standard buffered input/output package 
ee ee string operations 
ha aU ESI ORE RN gS sttseeecaeeeeeens swap bytes 
ee ee eee cseseseeeseeesneees issue a shell command 
ee ee terminal independent operation routines 
ee ee create a temporary file 
TEL TAMER .....create a name for a temporary file 
AN AP AIA MRA AEG trigonometric functions 
ath SES RN Torts find name of a terminal 
s aeseguuasesdeareseiane sssoeeeeseesseeseeesseesseeseeeees PUSH character back into input stream 
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4. Special Files 





DMN 5 20sec cea nce soca tecss basses sates st ee introduction to special files i 
ass eceureuessacec scan souues nc escent enaeountenanuanaectataceg sevase cosa ema nesnaeceeeuenes pseudo disk driver 
OE ces iedaca ade Silico tea Re cnet wse cae id eh cin obec t waa sa ynccescacea papa evinced senneoeees error-logging interface 
RGD ss ceescisece ssc vecsceecpn cc soescttsscdecencacaxoeceameenememcattuawautetiecs Intelligent Communications Processor 
TIMISP .00.....ccccesesescecsssccsssecccssecsseseeseescsscesscesesesessseessesessseeeseeeeeee I telligent Mass Storage Processor 
Dessert Sasser cata acsnnaceaecas aceasta cesons en see een eetcees cates oe iSBC disk controller 
DD seca sscesseasnctcst stan bia aly caunciienctestectenaensacteceeeuc: wast sashes uduG ob dana saeiaeceanaeiiadeiaeupandasanasaeesauie: line printer 
MUNIN 5s Sica canara cas caasdecen ewaktucueSasoananes test saindeesseteesecanrien Miesta Sette unease setae memory devices 
WOW ssa caw te eda hasneaacadelctadaaiaseu sian cranes ucsnelaveedee Liueeusccueseatvessgeeserasonresecamesaneecee pseudo tape driver 
OGM sisi e cise pataoeons es daca scracc sip reed Gegtatasha bach bastel duecat cde se teed tiateeuaesenetinse Keteinganpedaentegcceks the null file 
NOG sicipenze caaais ecgust yu enecsuaaandbuwsmanesaweais itt saetua neoel ceacssdededsaiccasaae sac ueasseeteroasmtea ean IMSC disk controller 
PO ie sagas Hesnsccescas ccs wees ca ta saps nn cos Savant ccc wuaeeato sles aoate tear eae eodoaateuenee parallel port interface 
ONE 52s she scae whan ts sencb ates ic eta cedeniyiadibccenuadcsuctaaleaatacince eansoeseasanseastsnsececstaceutessats operating system profiler 
NOU csc sasece pea Sec teatee ean Gosact cea tat dass Sewate aed naciews ah neh es ahve aad abanine ee Madero ea naasess IMSC cartridge controller 
GUT sooo ease citeDiecadcccntinn cada canamieings ceucetetcekveahaaanen tae seanasenedsuanmeabetans Cipher Microstreamer tape drive 
OU as esis eaten dee aks sense a dese tear ok tameaeaawe san cwledeeeswecastancarens synchronous terminal interface 
EN 5s ieescei isc asa ch ch aces teas naa aa sanaceteed acess ones tbncaabanesicasaciamsouaaiecsesseeates image of the swap area 
| fo: - nee ee reer Deseo ecm Rann mere er rere rere ne rere rere event-tracing driver 
UY sc dnisaascsede cece cided seb cdaecdacwevanucadedavesarpcpeetnccatssesdoeasbaadiovensiestseom sae generar terminal interface 
WIEN ss sivs sae Band csancas veee sud eatdaneanes ti eb sazotouedencnuaanseeraseusoeaenes eaurbarnienarneerss nace the Virtual Protocol Machine 





DINERO Sessa sisscusiods oho seach satin shaweans eee seaceaseaeg se tadueneseease eee tacate: introduction to file formats 
UN esicessvca estes schist seta dca ee tnaweeeanate se sieumseeas taeeseretes assembler and link editor output 
BOC osc oshestasiessesdetaceaitaues congas euaenstuneeea ays cis sanidesseaneomsaeniniesessa! per-process accounting file format 
OE cdasccdecsabeaveustsiaitentstxdanaciesacwadencecanantsaccens b sous Messaundaasunaeaneadiaucdcistseuasntan soe senceeiees archive file format 
CPO CHS E sicdassedi dace cise acdvecceesbaoscduus salves east ectaa eee ane tve list of file systems processed by fsck 
COM ekki aa i aiceaievanaeanstanteateacense sacl xncanadeccescusesasueed: format of core image file 
CO sess a cis tstiinsiasacecpseieast sucasea nutes boibeab canntedeyenodeiatauanesaabitncteanadeenseesbeeueeaccess format of cpio archive 
Do | ane BR ee Pe eneen ye omer eer enneee oomereE errr err rerrcrrr ery configuration file for NOS 
CU sais sais weet soa sade yaa aaraas cctacsu sac eatys sasuke iaavs els coceatacaaeamanambcondeusasiigesesanees format of directories 
CIN oases scocessen sec cunncbecstieduistoactets cena yivadvarucananeies Wecesaatvassgaessactaze des incremental dump tape format 
UU NG icc esa adeche sei ac cas ancdwseabancinuncanceestiasieaaccanes aaaebe cee masecea send as acaweaeuebaes error-log file format 
_ ene PEE RPS PP Ene eB ony one eee eee en eer ren rer ee reer er errr rrr ree format of system volume 
EOC axis facsesesasteyses casas dcsd pecs basa ne benacdes Sessansed tesesueeeeeueseeeseete. format specification in text files 
QTOUPD ......ccccsssessrcssscsssssscssscsrcessscucesssscessosoussesucsecerecessneceensnassssnsenssasessencanorsesancensossessooares group file 
OMIA S scocs sccdecscaweseccisecenicsiiasseiaiadssadeccatesestinesesaes define holidays and prime time for accounting 
MUI scans pclis essa ccea gassed Ceca saa cate wc ieesinsd ae lah cacncdannoaceatad dessa sahameveawentst control information for init 
Tio, |; See eeeR PEE Se nD re ase rey a eee coe meer eons ener reereer emer rrr re rrr are re format of an inode 
PVAUNCRERDD iso cigsancccececan Sauce sesavelaceataneuaad sea ees ened tnaansundccessaatececussacemeavenecst sues’ mounted file system table 
DASSWGO. ............. ss sessccecscsscecssseceseseessenteensecesscensassessasesscesennreesascesesssnassesssersceaseatoess password file 
DIOL.............csssccssscecsscccescsncccesssnsessscessscsesessecesseessnsensneecsssasscascessasscnsesousonsseuseeees graphics interface 
PINCH. 0... ceceessscrecscnesensceccsessncsseeeneessnacsnsseeesessesesscsseesesscecscneassorsnses file format for card images 
PP ORIG os csececinstdidccsiacepecctvnsstes sess cacshnsedusteaunasesevse Seeeseazatece? setting up an environment at login time 
SCSI acess is ics coches cccis era esstccaeed cesta teema dees tensete enon csniaeaannans covearsdstiGnselvsea: format of SCCS file 
TOLITICAP........00...ccncsesssscconcncecccesesonensccssacsecuccsssonensensssauesessssssnanansconeseses terminal capability data base 
UP .....cescccccssssccccsssssreesssssssesssnsceeessssceeessnescesesenscsssneressaseeecoascoasesescosnessusesaneeers magnetic tape format 
ttytype ........ cc ccceeeeeenees ethad pint dea tonsa diaan Untadeeieceteieeanea data base of terminal types by port 
URINID .......cseecceresssscnnccecsccrcccsosssscossncvensesecsenensensesesssanssssccosensoeneesonsacees utmp and wtmp entry format 
WUC OIE oo ecto Sosseladeteicieeleieiel nis caceiasstdeaseetgecia ce: configuration file for NOS Virtual Terminal facility 
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6. Games 
MTVU Oe ict St cnas 6 uh veg satus facie aruen sat ae ae rake te eatictlacd facnaeisenicéasee unas eieeee introduction to games 
EMO UTEITROEN G sve coiios casted sct aoc aes daonndesbirscacen sea eueSiaeeeheadeaanern cate provide drill in number facts 
OO 25 races eed coe atti cease iencacseasacasetcaacsieGoaieecs msdsieeiastieneadeemSewekiel the game of backgammon 
WY saints ba ce shad cena cs tions ees ea apatach ad iaedfal ate doaaniaaneacsiaaabieeeecetasaeeiaaseie, the game of black jack 
CEOS iiictiasersd dee tnseienecnwedey sdedeaoans sexe diuldoskenesios coadsseceatnavuaitevacastousenudaebealaestekeseeuak: the game of craps 
DUS shape anceetsn cine oasnsc cet oat oe 6 Bigah ga cent dactacu ue udiseeti sede edad agen sient ieta the game of fish 
ANGINA 535. ich ctaindas eta etaee Adie. Socictu aa Vases seesn cuba cennnaaiatentacedonehessua guess the word 
NINO oes she tcas estab cine. ion oaioanaa oveavisa chad casadecdisledeea dete bunn caguatGestasuonanieicautaceatacee aon guessing game 
WU ctivcts agian usapininai asa saliotanesa aecronesemd cauloteads eds sactans haa guaus giezsundeavanueestsxeeebats ebcaciiiitlaceuaeteeokes tic-tac-toe 
WINN ass da weressase satel dasck spans eed vad sa rendveskxeaauctawnasausen waco bedenouceutadeowades the game of hunt-the-wumpus 





SNE see cic rceseans aise Soils va atin cetaion cuicteeric aval dae osnagudasies tage teaheuuseanteoweneted introduction to miscellany 
SOW eiccecssicst soc st iawieer uit Posaced aie 70 scaGaa tau niaciseadwinlesesantoe aevaoiseaneee map of ASCII character set 
IVY IC OEY cuss bansScloc ry Sel aad a dea toeseccatasaeece ss eed entnone ouwaredeel can ousesbodeoetscanceesiekek user environment 
CONC AG ioe eicnsceiicndaceiasste dei acasessqucsceaslanseebeccecedeedess special character definitions for eqn and neqn 
BIN acter ceases tena gd as aseaceranmeau sade terun suaaecntetine se ttaneaceersiancs o.beeetuetiatcoenesutiuect file control options 
ECOG ics eases oes Hin ace cncheset uses etc Gees graphics for the extended TTY-37 type-box 
IVAN vacecesetaessebetie sees stestvatodeosaenetea vend dana ceheeavaauseiciiet macros for formatting entries in this manual 
NUM ccs cieasonccttandctntcch cst sock 2 tianalae lace, ec ncaa: the MM macro package for formatting documents 
AVN SS ccs cc cuiadeloneonc cessing sg wale tan slecatyovecdudecwecdRbsamorewesasecestseemuaoseneacoracs macros for formatting manuscripts 
NIV Yc cisaece sec cinsorsan cocernuwanaaieisieass vs Pesteustncedenenneessacanesoiees a macro package for making view graphs 
WOON DD ahi cisse seas stins sacddauxcnesaceeucuasenusauwacstnauestewaceieess regular expression compile and match routines 
SUN sei ake lnhedeay sce vaceriececanwabaxsausuoeancacdsdeaneaeds Saieacseuneentnde Reeatuless: data returned by stat system call 
MOOT es foeceseniwe vse deseo awsideia: sear tonsccetsace tie ces sadeabYadaesayecnuaseincscadnsant ad eyadeticnneatenaa hee conventional names 
MOS sic cseair cass teers ese cinadantekadeacanesiasaasenaee thee ds acici Cowtanacboesueuss primitive system data types 


REVUE ses ass sacteaits pay saietasbiaccdi Need introduction to system maintenance procedures 
PUNO OOK sissies seas eet ross neecatecediase banca cscs uatddbaedan bec eediveedeckadeons saeeeraecauidlncdl automatic reboot 
MOS ON sissies sais Scat ta ac acceded exec ocean ede ches oe, what to do when the system crashes 
CONT 6s sistas secesaea cen dece acu an canes edocs eds navies tuavasestteducceae ates Sueldsctasiwies configure logical disks 
NONI NN sssa s5 ssse Airs Sch cde eeia oem olen saascnas eas Gass Hi cae ecteak dase bels Satie Soceasbaieseckcdas disk formatter 
BECK ra bess esas sie ev aadaridishas a nel ecticieheeeneash make a fast tape backup of a file system 
WNOS AVG. 2655 csictcc sees be ctescciesssacdusdecbopvdeatevesisiaccdesaistoenenaes daily/weekly UNIX file system backup 
UY ics caa eee taoe ett A Gatos asacctitesceaedacsalipsdoescoousaacassatoocsanscneeeneen: set the modes of a terminal 
SOUL CR isis tes cctees caeesnctehacewtasanvbadececdesseecand Gusstedicai ee ee eaekeaeees defining speed tables for getty 
LS oe Ros PRR Se ne en me process control initialization 
NER OR OY i cs:is cesses cetd Senteinicasiaacistacticewidedusuihes seve mmunauestencecasea Guanes easeiccick generate encryption key 
WYONG 6s, csssetnssauhecccnedenaicsseanianscectveuesesobateivarsceeancniecon eee how to remake the system and commands 
NG cseaecucactecameseus sees seadaunessltagac sensei wasalaceacacassunseeasbaswuunaousesecencuucenee ued system initialization shell script 
NG as saisn ce taaiad sig ecea cans serene becuase ddondaSandeadisguneseecacatesoossedesaaagee ace: RJE (Remote Job Entry) to IBM 
SOME screens ta eau nce via Quc Mae eicat esas ace acon eedacctepesnaanstaledaivenaciiesensadinedes system activity report package 
STV UI soso ct seis os Secs actadetesssaviedieawase ds taalesddaciectidea oie terminate all processing 
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/functions of HP 2640 and 
handle special functions of HP 
functions of DAS! 300 and/ 
/special functions of DASI 

of DAS! 300 and 300s/ 300, 
functions of DASI 300 and 
I3tol, Itol3: convert between 
comparison. diff3: 

Tektronix 4014 terminal. 
paginator for the Tektronix 
of the DAS! 450 terminal. 
special functions of the DAS! 
long and base-64 ASCII. 


abs: integer 

floor, fabs, ceil, fmod: 

of a file. touch: update 
utime: set file 

accessibility of a file. 

phys: allow a process to 
access: determine 

acctcon: connect-time 
acctprc: process 

acctsh: shell procedures for 
runacct: run daily 

enable or disable process 
accounting/ acct: overview of 
accounting and miscellaneous 
holidays and prime time for 
acct: per-—process 

acctmerg: merge or add total 
search and print process 
summary from per-process 
process accounting. 

and miscellaneous accounting/ 
file format. 

per-process accounting/ 
process accounting file(s). 
accounting. 

accounting files. 





accounting. 


sin, Cos, tan, asin,’ 


sag: system 

sar: system 

command and generate a system 
current SCCS file editing 


acctmerg: merge or 

SCCS files. 

admin: create and 

alarm: set a process's 

clock. 

change data segment space 
realloc, calloc: main memory 
physical memory phys: 

of a document style: 

sort: sort 

send, gath: gather files 

link editor output. 
introduction to commands and 
maintainer. 





language. bc: 

cpio: format of cpio 
tp: manipulate tape 
maintainer. ar: 
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2621-SETIES TETMINMAlS. ............cccccccccccccescesceseceeeecesenssseneeseaeas hp(1) 
2640 and 2621-series/ AP: ........ cc ccccsssssttcceeceecessstseereees hp(1) 
300, 300s: handle Special 00.0.0... ccceecsssseeccseeessseneteeees 300(1) 
300 and 300s terminals. .............cccssscccsesseecesesseeecesseeeees 300(1) 
300s: handle special FUNCTIONS 00... ee ceeesesseeeeeeeee 300(1) 
300s terminals. /SpeCial ......... eee ececeeceeseeeeseeeennes 300(1) 
3-byte integers ANd ION! ............ cess cesecccsseecceseteseesseeenes I3tol(3C) 
3-way differential file 0.2... cccecsssssseesneeeeseeseeeseseessenes diff3(1) 
4014: paginator for the 0.0... ccccccccseccescoscecesseccccesereceeeeees 4014(1) 
4014 terminal. 4014: ooo. eeesesenereeeeeecereeeeneneeenans 4014(1) 
450: handle special FUNCTIONS 20000... cee esereeeeeetaneees 450(1) 
450 terminal. 450: handle ............ ee ccccccceseseececeneeeeeseceees 450(1) 
aG4l, 64a: Convert DEtWEEN 00... cece ceccceeceseesseeeeeeees a641(3C) 
abort: generate an OT fault. oo. eee ceseceeeeseerteeens abort(3C) 
abs: integer absolute Value. ............ ccc ceesseesesteeeesseeeens abs(3C) 
AOSOMME VAIS? sss asieiccreiassctcaveaaus covtetenecsnoeceeanxceasuseaveniananest abs(3C) 
absolute value, flOOF/ 2.0.0... eee ceccesescenseceeeeeeeeceeeseeeeseesens floor(3M) 
ACCESS aNd MOIfiCATION TIMES oo... cccceeceeeseeseneees touch(1) 
access and modification times. 00.0... ee eeceteeeeseeeeees utime(2) 
ACCESS: GOLEM MING: sssissidccsass sidsvzsissnsieianss asadsiraciaeaeiiy Weowstevees access(2) 
access Physical MEMOLSY ...............ccccsscessesssteeceecseeeseceeseesees phys(2) 
accessibility Of a fil@. 0.00... eeeecscsesesssseceeeeeeeeseesseeessssnees access(2) 
ACCOUNTING «bso inctetes tases wecudanaueseesheareavnitasaaalacsiaouanenwcenies acctcon(1M) 
ACCOUNUNG:: cecratceinasi cies alo ecetincdaliasiotonicaeeeae erie OS: acctprc(1M) 
ACCOUNUNG sus ctsae sSigacticsmaniieeivecniar dears ine teadmansnaacsursieae acctsh(1M) 
ACCOUNTING? 2: sensi icaintiniied ane enamel runacct(1M) 
ACCOUNIING: “ACCU ui. cessh  cecases couse rewetudisadeaceianiseidemecietvaesoanies acct(2) 
accounting and MiSCeNHANEOUS ........ cect eeeeeeeeeees acct(1M) 
ACCOUNTING COMMANAS. /OF 0.0... ccccessssrsceseesssstsneeeeceeseees acct(1M) 
ACCOUNUNG; “GOING. .ceesecsseedccaresets holies Maciek nrehocaaiaenes holidays(5) 
accounting file format. 00.0.0... ce seecsseneceeeeeeeteennaeeeeeeeens acct(5) 
ACCOUNTING TOS saciisgas miweiser ca ieee es acctmerg(1M) 
accounting file(S). ACCTCOM: 0.0... ceccececeeeecceneeceeseeeenees acctcom(1) 
accounting records. /COMMANA .......... ces eeeseecesseeeteeseeeees acctcms(1M) 
acct: enable or disable ........... cc ccecscsssecceeeeseetseteeeoeeersegs acct(2) 
acct: Overview Of ACCOUNTING 20.0... cece cceeeeettneeeeeeeseeees acct(1M) 
ACCT: PEF—PFOCESS ACCOUNTING ......... ccc cceesesceeeeeeeseeeeeees acct(5) 
acctcms: command summary from ...............cccecessssereeeeeeees acctcms(1M) 
ACCICOM: Search ANd Pint .......  ecceeeesereeeesertesseanes acctcom(1) 
ACCICON: CONNECTING sxe ic ccincsessasavecnsabsdixesvordenssvscebaventioncises acctcon(1M) 
acctmerg: merge Or add total .0........ ee cesta eeeneeneeeees acctmerg(1M) 
ACCIPIC: PFOCESS ACCOUNTING. ............cecccccee seeecseteeeseeeeteneees acctprc(1M) 
acctsh: shell procedures fOFr oo. eee cceeeseseetereteeeeeees acctsh(1M) 
ACOS ALAN BAN?! — ccssesesyiciassevessiecss Mavcncatsyevasiviascavomncaavenenes trig(3M) 
ACTIVINY ADIs. 2c caskel peas ctetiseed enn nea te teatecsphtastenguaeaninrecddeesuespanten sag(1M) 
ACtivity TePOrt PACKAGE. ........... cs eceeseceessseeereteesersessstneeeesees SAM(B) 
ACTIVITY FEPOM:. MIMO Oe ais decsnsesnesivccrlenseientecdiedd Aeneceetinweorts timex(1) 
ACHVIly: “SACI: DNA uch aaa ak Ged sact(1) 
AAD GODUGG Claes it eriecee clananeeeoarneriateediatenauneiie adb(1) 
add total ACCOUNTING fIIES. ......... ce eccsstcetestecesseeceesstneeeeens acctmerg(1M) 
admin: create and administer .................cceceesseeeceenesteeeees admin(1) 
administer SCCS files. oo... ccceccccssssccccesseceesssseeseecessneeesens admin(1) 
AIAN CIOGK :. agisecs strc crusrsnesiaceeseadccnuhas cesarean aaanevene alarm(2) 
alarm: Set @ PFOCESS'S AlAKM oo... ee ceesstettteteenenaeeees alarm(2) 
allocation, OM: SOM! i. Secisiesiced cs sca steed darocdaspedccanucsewebonvaveiotes ork(2) 
allocator. malloc, fre@, ...........ccccecccccscsesceee cessssessssesssestneees malloc(3C) 
AIlOW A PFOCESS tO ACCESS... ceeceseeeeesceeesseneeceseeeeeteees phys(2) 
analyze surface Characteristics 0.0.0... cee cee ee eee ceeeeeees style(1) 
And/Or MEGS: MOS 3. sieseiverseri reesei iiecantnadeioreguidinnsaisecwens sort(1) 
and/or subMit RUE jobs. 0... cee ecceeceee eceeeseeeeeeenesaneees send(1C) 
@.OUt: ASSEMDBIEF AN ......... ee ceessssecececcceceessessssetseeeaeeeeeeeees a.out(5) 
Application PrOGraMS. INTC: 2.0... cece cee eeecceeeeeseeeeeeeens intro(1) 
Ar: AFCNive AN LIDALY ........ eee ceecenteecesorteeeeeneeeeeeeaeeronea ar(1) 
ar: archive file format. ..............ccccccccssessesseceseneeeescaccuaaneereeeees ar(5) 
arbitrary-precision AritNMetic ........... cece eceessteeseeesseeeoree be(1) 
AI CIV G8 Bes ics oacecey Wie wee eee enon eernats tac a taet ees rec eee cues cpio(5) 
LCMV Gs oF ves sete re iracorencocarecintueense ene irenecienaseee ieee tp(1) 
AICHIVE:- ANG NOLAN icivcss. seclivcetees aticsepenesaaccseissaiccrasincneetes ar(1) 
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ar: 
VAX-11/780/ arcv: convert 
tar: tape file 

cpio: copy file 

arcv6: convert 

from PDP-11 to VAX-11/780/ 
format. 

swap: image of the swap 
command. xargs: construct 
echo: echo 

expr: evaluate 

getopt: get option letter from 
be: arbitrary—-precision 
number facts. 

expr: evaluate arguments 


between long and base-64 
convert date and time to 
ascii: map of 

~— set. 

atof, atoi, atol: convert 
and/ ctime, localtime, gmtime, 
trigonometric/ sin, cos, tan, 
help: 

as.68000: MC68000 
as.Z8000: 28000 

output. a.out: 


setbuf: 


sin, cos, tan, asin, acos, 
cos, tan, asin, acos, atan, 
ASCll to numbers. 
numbers. atof, 

numbers. atof, atoi, 


autoboot: 

wait: 

processing language. 
ungetc: push character 


back: the game of 
daily/weekly UNIX file system 
fbackup: make a fast tape 


bbanner: print large 

termcap: terminal capability data 
ttytype: data 

\64a: convert between long and 
screen-_—oriented display editor 
portions of path names. 

printer. 

arithmetic language. 


cb: C program 
0, j1, jn, yO. y1, yn: 


strings in an object, or other 
fread, fwrite: buffered 

bsearch: 

remove symbols and relocation 


bj: the game of 

sync: update the super 
bcopy: interactive 
periodically update the super 
df: report number of free disk 
sum: sum and count 


unixboot: UNIX startup and 
space allocation. 
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archive file format. ........ccccccccsssscseseccsesceeceeeeesessseessesesesseses QL(S) 
archive files from PDP—11 tO 0.0.0... cesssesssrseeesereessseneeueenenes arcv(1) 
AICNIVES. .....ccccscccccsccccccesccsesssssssnsccsorssessceseseserseneesssceccesoossanones tar(1) 
APChiVES iM AN OUL. ou... escesseeeteeeettseerereeeeectttseeeeesenaees cpio(1) 
archives to NEW fOrMAL. oun... se ccsettteeeeeereeteeeeeetteeaeeas ‘.... arcv6(1) 
AICV: CONVErT ALCHIVE FIIES ........ cece ssensteecceeseettetnereaeeseeeeeees arcv(1) 
arcvG: Convert archivVeS tO MEW .........ccccceeseseseeseetneeeneeeeneeenes arcv6(1) 
Clg ct: en ee eee rn rrr rr rr cr swap(4) 
argument list(S) ANA EXECULE ........csrererereserereteetereeeens xargs(1) 
APGQUMEMS. ooo. cccccscsssceeeseeeneeeeteeeterssesssasseseeseeesserseetsenaeens echo(1) 
AFGUMENTS AS AN EXPFESSION. 20.0... sree tteetettseees expr(1) 
IQV. casssecsssscssesscnsscsesssssrsussssesevesscenseseasaesenessscseseesesesseseneareeens getopt(3C) 
arithmetic IANQUAGE. ...........cceeeeestcsteettcentreterseettescnseeenseees be(1) 
arithmetic: provide rill in ........ cect eeeterttseeeeneeeens arithmetic(6) 
AS AM EXPFESSION. oo... cecessescceseereesteeteeseersessersestseeeneenseeees expr(1) 
as.68000: MC68000 assembler. .............cecceessereeeetseteeeees as.68000(1) 
ASCII. aG4l, 64a: CONVEFT 0.0... cece eeeeeeretteeeseteeteteeteeeaaes a64I(3C) 
ASCII. /ASCtIME, tZSEtl oo... cecscccecsetseeseteeersseeeseneeseeneeensees ctime(3C) 
ASCIl Character SOty accccstvraieadcisnciianciicnaiccdmitanetanisacees ascii(7) 
ascii: map Of ASCH Character .......... cesses ceeseeeeteeseeteenennes ascii(7) 
ASCIl To NUMDELS. .........c:cccccccsssscsrerssseseseereorssonccntessenarseases atof(3C) 
asctime, tzSet: CONVErt Date ........ cee seseccrereesssteeesteeeeeenees ctime(3C) 
ASIN, ACOS, ALAN, ATANA: esses ssteeeseestteeeeeeeteTeHEeS trig(3M) 
ASK fOr NEIP. oo... esssesecesessetseserssesreesssetsereessesesensnrssonenenes help(1) 
BSSOMDION. - xcccxiles Giri taine Gara itee nian as dasawedneesentet as.68000(1) 
PASSOMIOISN vec scad cx csacameissea tale tnce st ra aain sncaskdndeeea ion measvecennbn as.Z8000(1) 
assembler and link OdItOr ........cceceececececeeseesesesertteeeeeereeenes a.out(5) 
ASSEFt: PFOGFAM VEFIFICATION. 0... seereeercsee erteetteteateneeeseeens assert(3X) 
assign buffering to a Stream. .......... cscs cnet teeeenaeenes setbuf(3S) 
€AS.ZB000: ZBOOO ASSEMBLE! .........eeceeeccesesessteeeeesteneees as.Z8000(1) 
atan, atan2: trIQOMOMEtPiC! 0.0... cece sets ceteeeetteeeetseseaeeens trig(3M) 
AtaN2: trIQOMOMEHHIC/ SIN, ........cccerettesteestee teres et eteereeeeeees trig(3M) 
atof, atoi, atol: COMVEST .........ccsccscscetsessescescusseetseeeteneeneeenes atof(3C) 
atoi, atol: convert ASCII 0.0... eeecsccsestesesteeeseeeneeeens atof(3C) 
atol: convert ASCII 10 oo... cccccsscetecteeseescesseeeeesseesensaseneneees atof(3C) 
AaUtObOOT: AUTOMATIC TEDOOL. oes eeetttteeete terete cees autoboot(8) 
automatic rebOot. ............cccssssscsccssssrecerscsrssrcoreretesseeesonrtneenes autoboot(8) 
await Completion Of PFOCESS. .......... cece seeeesteeeeerttseeees wait(1) 
AWK: Pattern SCANNING ANA ........ cece cette esetteeteeetees awk(1) 
back into input StrOAM. ou... cece cteetscereeetesereteeteeenees ungetc(3S) 
back: the game of backgammon. .........cs cere rsteerseeeens back(6) 
DACKGAMMON. ....... ce ecsserscsesseseesssseseeseetestseseeteeteesatsansesnersees back(6) 
backup. filesave, tapESAVe: ......... eee teeetneetteeeteeeeats filesave(8) 
backup of a file SyStEM. ..........cccccseetee ee tteeeteeerteeeentenees foackup(8) 
banner: Make POSTS. .......... cesses sseeeeesseeeeeteseesneeeneneees banner(1) 
DANN OF DTINOM, ascii. stidanivesdsncsecedassiescis estes ebean casentgtigacdersess bbanner(1) 
BAS... cchss ei sadcesacbeasstiardesevaitinantoapanaaa tensa uteuestenaxaiare ice termcap(5) 
base of terminal types by Port .............. cee cetecteeeeetetereeeeeees ttytype(5) 
base—64 ASCII. AG4I, oo... eccccceeecseteeresrsteeeesnteeseeeenenes a641(3C) 
DaSEd OM OX Vio cecicisevcsiecrereitaceciaetisetions nas ann coembaaees agin vi(1) 
basename, dirname: GelIVER ............. ccc ssseneeestnereeetnenens basename(1) 
bbanner: print large DANNer ON ou... cece cet ttteeeeteeeerenees bbanner(1) 
be: arbitrary—precision oo... scscsssserseeesceereertetesteeserseens be(1) 
bcopy: interactive DIOCK COPY. .........cessecceceterteetteeeneeeees bcopy(1M) 
cliff: DIG’ Git: avpsiiseseeccenciasdean wiruednveattioigl ae sien eeeeaeaeiente bdiff(1) 
DOAUINOR: saatiics cencamatiat wid aem minis cb(1) 
DHESSEl FUNCTIONS: sce sossindaeielccchaceci clansmen ctaearehitceanmetetea tes bessel(3M) 
bis: Dig fIl@ SCAMNNET,. ...........:ccsssescesrscercesenscesenessnenteeeteeoeetes bfs(1) 
binary, file. /find the printable ..............cccceseeeteeneeseeenees strings(1) 
Hinary INDUPOUDUT cs. deciiiasiscieceescermniiinainieiiaiauseties fread(3S) 
DIMALY SOAICH. .o..cccccsctecccceeesevvosssssessersnsessnenttessateestensesoserorenes bsearch(3C) 
BitS 2 SITIO esi soasxecactcs hc tasee encase sen vimeenc an vsnceseen ele resad aaah strip(1) 
bj: the game of DIack jack. ........ cece tects rtertseeeaeonaes bj(6) 
IACI JACK © 2s sescecoctoipscyetes odectssssaaccarendtemiasetinie anaemia cies sues bj(6) 
DIGG scdscedes te eccscrisbre ee uncaeentay notasbemniteceseriurame cont sync(1M) 
block Copy ............. Aiden ie iaeaea ae eee dtancoond saan bcopy(1M) 
DIGCK: UDCA: is iccetecsa seated aecheavesn cassia aaa cae acetal update(1M) 
DIGCKS: secs caliass sathacesiiciem antes Cee Ree df(1) 
DIOCKS IN aM Se cscrarctircssssevsctaencesenrei arene ia aateeeanseidayeaess sum(1) 
bis: list contents Of GIrECtOry. 00.0... cece ceeeteeeetteeeeeees bis(1) 
Hoot Procedures: scsi cern nawe Awad unixboot(8) 
ork, sbrk: change data SEQMENE .......... cette etteeeeees brk(2) 
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modest-sized programs. 


fread, fwrite: 

stdio: standard 

setbuf: assign 

mknod: 

swab: swap 

CC, pcc: 

programs. scc: 

cb: 

lint: a 

xref: cross reference for 
xstr: extract strings from 
message file by massaging the 


dc: desk 
cal: print 


syscall: numeric id of system 
CU: 

data returned by stat system 
ct: 

malloc, free, realloc, 

intro: introduction to system 
link and unlink system 
termcap: terminal 

pnch: file format for 

pt: IMSC 

of the ex editor for new or 
files. 


commentary of an SCCS delta. 
floor, ceiling,/ floor, fabs, 
/fmod: absolute value, floor, 
'  ugrow: 

delta: make a delta 

pipe: create an interprocess 
stream. ungetc: push 
/isgraph, iscntrl, isascii: 

and neqn. eqnchar: special 
user. cuserid: 

/getchar, fgetc, getw: get 
/putchar, fputc, putw: put 
ascii: map of ASCIil 
toupper, tolower, toascii: 
style: analyze surface 

tr: translate 

directory. 

fsck: file system consistency 
eqn delimiters. mmchek: 
constant-width text for/ cw, 
text for nroff or/ eqn, neqn, 
lint: a C program 

grpck: password/group file 
copy file systems with label 
systems processed by fsck. 
chown, 

times: get process and 
terminate. wait: wait for 


of a file. 


group. 
for a command. 


rm: 
iscntrl, isascii: character 
uuclean: uucp spool directory 


clri: 
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bs: a compiler‘interpreter fOr .............ssccccseseeseessserstcsessereoees bs(1) 
bsearch: binary S@arch. ............:ccsccsrecsseeneseneceees ssansstebssiess bsearch(3C) 
buffered binary input/OUtPUt. ................csccsssoresssrsetsrrsesereeees fread(3S) 
buffered input/output Package. ....,.....,..cssscssecscsecssserceseeeees stdio(3S) 
DUTerING 10: a-StOAINs «is sicsinsccseceansccscsssseuscecoscvedeeisnecdesteorssaeris setbuf(3S) 
build Special file. ............ cc eeesescssssnteceesesssecerenes s.badar ean eaeuesee mknod(1M) 
V1ES x weds ca vccutavantadansiyteakaumeosat ven news hata iebeeboaudsusne Sexteesteds es, SWADLOU) 


C compiler. .............. sconstsiauatecten sea mnenceten GC( 1) 


C compiler for Stand-Alone ..........cssccccssseescessssssrsseccsescsseees scc(1) 
C program beautifier. ................... Re err Tre cb(1) 
C DIOGraM:- CHECKED: accesses sevecenes scout snracnareioetarancenieaiets lint(1) 
CG DEOGIAINS - sicusireansinncetitesnsastnsie erreruveenonneeaed aie raeeen ees xref(1) 
C programs to implement shared) ................sssrecccscesesseeneees xstr(1) 
C source. MKStr: Create AM EFTOF .............0.csseeseeesseceseeseneees mkstr(1) 
Cal: print Calendar. ...............ceecceeees Lou G are ca a cal(1) 
CAICUIAION : sissaeai fescesveadextevencnetensauwescetiess Sa apiaSncteoenes soaneaeeioeaubias dce(1) 
CAIONG AN. sccccsstarncautodtaetaaieaeoseeanes sidaevasdsnesessieus deoescashaeaussseeans cal(1) 
CAlENdar: FEMINGEL SEFLVICE. ..........csssecssssrsrrrcrrsresssseseceeccoreess calendar(1) 
Call. saccshsniecueseusdetina sacaucanty sos coestadanans get eresnaaustateathehisnevomewteaas ee syscall(2) 
call another UNIX system. ............000 fects acl OR re ater cu(1C) 
Call. Stale si tite e cdclorssaerestaseersanaceedeaceics se locbuaseteepivhanh sates stat(7) 
Call TOTAL 65s Reevasecsadtevorssaeeawasuncnaeesocesuncenvens i rast ote ick ct(1C) 
Calloc: Main MeMOry allOCatOF. ..............scccsccssceccrserssssrssrecees malloc(3C) 
calls and error NUMDBEFSS. .............csrevsssreooees peduadeaidaaevastocueles intro(2) 
calls. link, unlink: exercise ......... se eodecnniss vsuvacbisvauhueaaciectesonel link(1M) 
capability data base. .................. sesteuaites picdceveuassivereamendsae termcap(5) 
Card IMAGES. 10.55 5s Sass eavigattacauceanghle catsanvepibiteincssndeioatsrvaeese PMCID) 
Cartridge COMMIOIlEL. ................ssccccccesesssvssssceeres satu sierceassctiaeeus pt(4) 
Casual USeFs. /ECitOr, VALIANT ..............csscecerscorseccecerseeseceeeeees edit(1) 
cat: concatenate and print ............. Sus Voeausennsese fapapeauusvateasss cat(1) 
cb: C program beautifier. ............... ance wesadavansseds eediaewananescdee cb(1) 
CC) PCC? C :COMPINCN  esisasskt ie a ieeeateccest icra eee aassstendccavs cc(1) 
cd: change working ireCtOry. .............cccsscosscesesseseessessteeees cd(1) 
cdc: change the delta .............. aneeteds sibedgas Sos eutspaiecseactecmewse cdc(1) 
ceil, fmod: absolute value, ............cccccceees sta tias ASeeeeeaueaakud floor(3M) 
Ceiling, TEMAINGEL FUNCTIONS. .............cccccecccsccceccorrecssctseseeeees floor(3M) 
Change System Stack limit. ..........cceccccsccccececrersertcsssesseeeeses ugrow(2) 
(change) to an SCCS file. ............ecssssscscserererecsnsesssceeeeeeeees delta(1) 
CHANMECL: vcrecesevsscanscsiostandsctenenaiaasvateats sista lewts esocuddsinusueadersuevast pipe(2) 
Character back into iNPUt ..............ccsecsoscsessssereeseees ae ee ungetc(3S) 
Character Classification. ..............cccccsssssssssssrsocsssesssssserscceesees ctype(3C) 
character definitions for eqn ........ sopetae ts ssa aint ausmelsuespeine: eqnchar(7) 
Character login NAME Of tHE ...........ccccccessesssccessececeesessserees cuserid(3S) 
Character Or WOrd from StrOAM. ...........ccc:ccscccesscescsscesceserecs getc(3S) 
Character Or WOrd ON @ SITEAMM. .......ccccccessessccccescsessesesssneeees putc(3S) 
Character S@t. 0.0.0... csseeessseesseees iasudeatiaes isaeawiaeunceosesncets ascii(7) 
Character translation, ...............ccccccccesscseeees bacdoeveniaveacyacmeous sere conv(3C) 
characteristics of a document ....... scab Riec alee aaa eet style(1) 
POLAT Lg: [07 (5 | ase eee re CP tr(1) 
Chdir: Change WOrking ................cccssssssssssscsssssceessesssssasceseees chdir(2) 
check and interactive repair. .................. Sisvasetenenee Seuametent fsck(1M) 
check usage of mm macros and .............. Nasaleauisseereisteceteaes mmchek(1) 
checkcw: prepare ...............sscecces isetleseGaes Weireees 2avanousetecits cw(1) 
checkeq: format mathematical ................ pdasavvseesesagessiaces ted, eqn(1) 
CIO CRON ccs sah oeccaseas A Gssutatedicsticedcvouhdedeveticecsauevssieesa sane cucelens lint(1) 
-ChECKErS. PWCK, ........:.:cccccescescrrecosevees ie cnayinaidinnedlouwesesoutatuae eat pwck(1M) 
checking. volcopy, labelit: 0.0... eecseee ceecssesesccsetesseeens volcopy(1M) 
checklist: list of file 0.0... essseesees ws hecueeuan auseencen cueniatosins checklist(5) 
chgrp: change OWNET OF Grou. ............cccssscccsssssrerseseccsseees chown(1) 
Child Process tiMES. ..............sscsesessccsssosevevssseececsssssteesesseesres times(2) 
child process to StOp OF .............ccssesees ssbaeeeedesuaspdeanseadeesaeders wait(2) 
Chmod: Change MOE. ...............ccscssssesssesvessscevccegescscecsseeeuss chmod(1) 
chmod: change mode of file. ....... was Vague auetoiiavie Gann tusneeac sence chmod(2) 
chown: change owner and Group ............ccsccsccssesssserecceeeees chown(2) 
Chown, Charp: CHANGE OWNET OF .........c..ccccccsecenseosececceseeers chown(1) 
chroot: change root directory ...... deduced autioigizeluodesnticne2 Reece chroot(1M) 
Chroot: change root directory. ...........cccseseeseecsevesesssveeseseeees chroot(2) 
Cipher Microstreamer tape rive. ..............cesccessssessccceceeeees rm(4) 
Classification. ASQPAPN, ..............cccccesssccessessesessssscsssccsecesenes ctype(3C) 
CIE BAUD: in sector byceceolstleneaal Goalies sei e lit cata bans anctabiai seule vasiaticetss uuclean(1M) 
Clear: clear terminal SCrE@N. ................ccccscssecsescesccccecseeeeeeecs clear(1) 
CIO AN 1 ONC srs cs fasks cr can siaunananebsdsatcoaes eaescseeeewelenteeus clri(1M) 
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clear: 

status/ ferror, feof, 

csh: a shell with 

alarm: set a process's alarm 
cron: 

close: 

descriptor. 

fclose, fflush: 


line—feeds. 


comb: 

common to two sorted files. 
system: issue a shell 

test: condition evaluation 
time: time a 

activity/ timex: time a 

nice: run a 

change root directory for a 
env: set environment for 
uuX: UNIX to UNIX 

quits. nohup: run a 

rsh: restricted shell 

getopt: parse 

sh: shell, the standard 
per-process/ acctcms: 
argument list(s) and execute 
install: install 

intro: introduction to 

how to remake the system and 
and miscellaneous accounting 
cdc: change the delta 
comm: select or reject lines 
icp: Intelligent 

diff: differential file 

cmp: 

SCCS file. sccsdiff: 

diff3: 3-way differential file 
dircmp: directory 

_ regcomp: regular expression 
regexp: regular expression 
regcomp: regular expression 
cc, pec: C 

programs. sce: C 

protocol machine. vpmc: 
yacc: yet another 
modest-sized programs. bs: a 
wait: await 

pack, pcat, unpack: 

Cat: 

test: 

Virtual Terminal vtconf: 
Network Operating/ D-hosts: 
dconfig: 

acctcon: 

interactive/ fsck: file system 
report and interactive status 
cw, checkcw: prepare 

mkfs: 

execute command. xargs: 
nroft/troff, tol, and eqn 

Is: list 

bis: list 

csplit: 

fentl: file 

st: synchronous terminal 

ve: version 

ioctl: 

inittab: 

init: process 

font: file 
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Clear terminal SCFEEN. ...........cccccssssssetotsceecsersesnsnsereeeneeeeeseeees clear(1) 
Clearerr, fIIEMO: STFEAIM ..........:ccccsscsccsesssesssreeeseseseeoeseseeeseees ferror(3S) 
GNSS MAX, ses secccck res cstasoneste dad oaticvosvepntuhanensesateeeseeeseenserts csh(1) 
CLOG 2.5 Seswetentidetwsnsenthatanceietieei ce unecas vane aniaioceeotsetineeraaG alarm(2) 
CLOCK GACMON : isseciceds icdccsscacccinscipeneswenpecaaelaveradeorseadeorneses sie cron(1M) 
Close a file GESCTIPION. ..........ccccccscsssecrsccscrereesteeceseceenecseranes close(2) 
ClOSE? CLOSE: A $IG: civis sesssvsiee dd ccissacerecaasiaricanors ser ctozedssouvensevacnsss close(2) 
Close oF flUSH a StPOA@IM. ............ccsccccsssreeeserersesoesressseeceessees fclose(3S) 
Giri Clear I=NOOG. ccisecncecasidcetinegatets esterases clri(1M) 
CMP: COMPANLE TWO fIIES. ..........ccseccsresnecsseeererseeeteessasensseteees cmp(1) 
CO! filler TOVEISO cine cncdininitciniieiacaiwuananars col(1) 
Comb: combine SCCS deltas. 00... cccescesesecssccessseseeseees comb(1) 
Combine SCCS deltas. .........ccccssscsssscessssssccssereceseeesseeseeeereens comb(1) 
comm: select or reject MNES ............ccsssserscesssssseeesereeeeooes comm(1) 
GORING cscs coool a seciancnss covery aecasancenaseauanseor atin come ndante system(3S) 
CORNING: ic icoss cease rtcnessinevcdeccncuseseiiveencrcessalute heh daeveeiawiaiets test(1) 
COMUMANG - hressketien eliecketns arctica ieneeretass time(1) 
Command and generate a SYSTEM ........... cs ceseesseeeeseeeenteees timex(1) 
Command at low priority. ........... ee ceteccerereeetteesstereeeteoeees nice(1) 
COMIMANNG: - CHIOOLS. es cisicseiasecivcsiicorcussiveacssteadeisnausncstenisnnennttons chroot(1M) 
COMMANM EXECUTION. .........ccccccessssscececeseetecerecessstsceesssseeeseeees env(1) 
COMMAN EXECUTION. ..........ccccsssstecerssssstceerecsessseeseesesesererss uux(1C) 
command immune to hANQUPS ANG ...........-ccccscsesteeersenens nohup(1) 
(command interpreter). ........ccccsesescsreereereeseessssersenssernees rsh(1) 
COMMAN OPTIONS. ..........cccecsercscscerseenreesscereecsteecseereesesereens getopt(1) 
command programming language. ...........csccesssecereereees sh(1) 
COMMANA SUMMALY FOM ...........creccccssrcesrerentecettseraeeeseeees acctcms(1M) 
COMMAN. KAPGS: CONSTLUCT .........ccccsrrcecsssrseressseseeereeeoseees xargs(1) 
CORTES &dosescosesiscesyosatpacesenspeiaratndoceuad esac anesevatacatatasereede install(1M) 
Commands and application / .............csccceseveeesseeesesteeeseens intro(1) 
COMMANAS. MK: ...........cccsssssscsssssvesssecssssnsesetesenesesssssenenensesers mk(8) 
COMMANAS. /Of ACCOUNTING ............cccecersecersreceereresensensesenens acct(1M) 
commentary of an SCCS delta. ...... ccs cde(1) 
COMMON to TWO SOMME fIIES. ............  cccesserteeecesseaeeeestenees comm(1) 
Communications Processor. ......... csutacivatictustensasen ects icp(4) 
COMPALALOL. 0... eccsssccsesseseerseesecteersensssssesesaconsenesseseraseeneeeeers Giff(1) 
COMPAL TWO FICS. ........cscesscseesrensreseeetenseesreeersensesseneeenessees cmp(1) 
COMPALe TWO VEFSIONS Of AN ........cccerrrseroreerressetsenesrseeeees sccsdiff(1) 
COMPALISON, oo... sccscsssssesetseeeesetsenessesestecenensoneeseneessneneneenesees Giff3(1) 
COMPALPISON. 0... ececsessscssesneeeesnesnessseaserasensnsasseaeesnesnesterereeees dircmp(1) 
COMPLE. 0... cscseccscssccersenteensetsstsessscreerecnesssessscesensensesseeeeaes regcomp(1) 
Compile and Match routines... crersereesereeesees regexp(7) 
COMPIIE/EXECUTE. FEGOX, ........sccsserererrserecrenresveserseerenseeesenees regex(3X) 
COMPOS. 00... ccecscssscsssesscsseecesnssncteetessserseessessesessseseseneenessenaey cc(1) 
Compiler for StaANd—AlONE .........cccserescerssersesssseeseeneetetsenees scc(1) 
Compiler for the VirtUAal ...........cscseeseeeterserseeersseeseseneetenes vpme(1C) 
COMPIEF—COMPIEL. ..........cerceresseeresetseeeseseessesteensenssasereeetsees yacc(1) 
COMPpiler/interpreter FOF ........cccccscscreereecrsseseteeeerereeereeets bs(1) 
COMpletion Of PFOCESS. .........ceccscsrssesereeserecrserseesetreeresresees wait(1) 
COMPFESS AN EXPAN FIES. ...........erserrccrorersereeneeereeereeaees pack(1) 
Concatenate aNd PIN FES. ............eceesecesssteeeseressonteeesees cat(1) 
Condition evaluation COMMANG. .............ssserecsrrscsesreserseevees test(1) 
Configuration file for NOS .........scsseseessesersssesrenseeesenes viconf(5) 
CONfiguration file fOF THE .......ccecsssecssseeseeressssensenessetsenennens D-hosts(5) 
CONfigure logical CISKS. ..........sesssssrsseererseserersrsseseeseseeneenes dconfig(8) 
CONNECT-tIME ACCOUNTING. ..........cscsssccerreesssssrseseserscssoeesoces acctcon(1M) 
Consistency CHECK AN .........ccererseesreeesseseesseseeseseeeeereaees fsck(1M) 
Console. rjestat: RUE Status ........csssesereecesteseesseectsenenens rjestat(1C) 
constant—width text for troff. ........ccccccsssesceceteesestnesssrseenes cw(1) 
CONSTrUCT a fIIE SYSTEM. ...........cssscesrceeresrssersseressesssenseeeseeens mkfs(1M) 
Construct arguMent list(S) AMA .........cscerecseereessteeseees xargs(1) 
CONSIIUCTS. GELOff: FEMOVE .........erccccccccesessssseeseeeesssesesenenes deroff(1) 
Contents Of GireCtOrieS. .............ccessecsersnresessseesessrescenseees is(1) 
CONTYENES Of GITECHOLY. .........cccesscssseccrceeseetsesesneeeseesserenseens bis(1) 
CONTEXT SPlit. oo... cceeccecessessecsteesesteenseeteereassscnsseesesenseees csplit(1) 
control. ..... sedhseisd Toca ah oc dans oe an hue sa siuatie van ed uaa sD satea seared enuean tugs fentl(2) 
CONTI, icici cos sdacddccsasusaeacieareagidnoeienatescnsvccansuantecaiadertetensyesiyeseys st(1M) 
COMMON: ses okcasenssissdevcevauaesdyecguseten sewed sasesconssisavsies tevzenanss savssassaveyes vc(1) 
COMPO! GOVICE. .......cccccccccsccseeceessssssseeseeescocccesceeseenenersnsasonseaees iocti(2) 
CONtrol Information for iMit. ............cscscsccccceeescesseerereererseseeteees inittab(5) 
control initialization. ........... bdvea vsbiiesauedcustpaseat utaesusameteuniausaase init(8) 
CONTPO! OPTIONS. ..........:sscsccsssessssseosscnesrsseesersessneesesensseseeseeees fenti(7) 

= A 


Plexus Sys3 UNIX 




















uucp status inquiry and job 
is: iSBC disk 

pd: IMSC disk 

pt: IMSC cartridge 

term: 

ecvt, fevt: output 

units: 

sscanf: formatted input 

dd: 

PDP~11 to VAX-11/780/ arcv: 
arcv6: 

atof, atoi, atol: 

integers and/ (3tol, Itol3: 
base-64 ASCIl. a64l, I64a: 
/gmtime, asctime, tzset: 
bcopy: interactive biock 
dd: convert and 

cpio: 

checking. volcopy, !abelit: 
cp, In, mv: 

copytape: make an image 
uulog, uuname: unix to unix 
public UNIX-to-—UNIX file 
tape. 

file. 

core: format of 

transfer to a/ icpdmp: take a 
mem, kmem: 

atan2: trigonometric/ sin, 
functions. sinh, 

wc: word 

sum: sum and 

files. 

cpio: format of 

and out. 


craps: the game of 


rewrite an existing one. 
file. tmpnam: 

an existing one. creat: 
fork: 

Ctags: 

tmpfile: 

massaging the C source. mkstr: 
channel. pipe: 

files. admin: 

umask: set and get file 
listing. 


programs. xref: 
cref: make 
more: file perusal filter for 


encryption. 


for terminal. 
asctime, tzset: convert date/ 


ttt, 

activity. sact: print 

uname: print name of 
uname: get name of 

optimal cursor motion 
screen functions with optimal 
spline: interpolate smooth 

of the user. 

of each line of a file. 
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COMMON UUSTAL sic fa ssiodenserutielucs et antescsetarsalen acsttes eanencoeate uustat(1C) 
COMMONER: « sicczasssasdccarcantiessautue aden scnnravesareetsecoieimaacdiedes ates is(4) 
COMTOMCD suse saaesi tcc iecau enn vadectn tae vusncrevnccave. tse Gunetesbvasenetels pd(4) 
CONMONGN, : 2escnisicssaiinctsnanantolercveasiheveiesyssecseota sansciseinsdeusees bine pt(4) 
CONVENTIONAL NAMES. 0.0.0... eeeccecssseteccesestscessesessesseesseseenes term(7) 
CONVEISION .. Siiiccsxtssuraiae nsveehertaicieseseencaindeamones ecvt(3C) 
CONVEFSION PFOGFAM. ou... ce eeesseccssssseeccesessrsceesesessensescssenses units(1) 
conversion. scanf, fSCANF, ..............cccccccssessssscsscsssessssscseees scanf(3S) 
convert and Copy @ file. ooo... eececccccccescccceeeeesseserseseesess dd(1) 
Convert archive filOS FrOM .0...... eee ccessssetesceecceesceeeseseseraees arcv(1) 
convert archives to NeW forMab. 0.0.0... cc eeeessseseessneenees arcv6(1) 
convert ASCII to NUMDETS. 0.00.0... ceeecssssesesssscessscuserseeseees atof(3C) 
Convert between S-byte ooo... eccecccsscesesssscesssesserseeseenes I3tol{3C) 
convert between long And ..............ccccceccessrssescessesevesseseees a64I(3C) 
Convert date and time tO/ ...........ccccccccscccssssssesececsesssseneeseeseses ctime(3C) 
CODY cis sissc as vireo satis Soeur nce sale ta snrecten ecco neistanead eel bcopy(1M) 
CODY TUG sa icestee py saps inceee eta teeacececlevesoavanenanictaadasedmansies dd(1) 
copy file archives in ANd OU. ...........ccceccceccseeessesscccesuseseesees cpio(1) 
copy file systems with label ........... cc cescccccsesssseeneseeseeees volcopy(1M) 
COPY, lINk OF MOVE FIIES. oe eceeteecceseesessssesssseseenseees cp(1) 
CODY: Ola (AD aici cele ae ead arsed i atinaieeeises copytape(1m) 
CODY GUC eisctussastrcssocteanctsrarsontasssiansseucescueslenstcanuaccrent ingens uucp(1C) 
CODY <GUIO UUDICK: scctsccciiescuchsionnt nein as eel enema aaeateets uuto(1C) 
copytape: make an image copy Of a 00... ee eceeesenes copytape(1m) 
core: format Of COPE IMAGE 0... ccceeeessssssteetstsenesereeeees core(5) 
COPS IMAGO TG ci cies antic svar cutececeecvsngs ensveeecasnteadeeaaaiesewesaenens core(5) 
core image Of the ICP and ou... cccscerteessesecsteeeeseeens icpdmp(1m) 
COPE! MOMOlY na stoiecstacesensstcreri i ocien vcestennaurasaenceatectinuens mem(4) 
COS, tN, ASIN, ACOS, ALAN, ou... cceeesseseesseeseeeeeeeeesenes trig(3M) 
Cosh, tanh: NyPerbolic ..0..... ee eccceeseeeessssesseesseesecenseseess sinh(3M) 
IN sears caine cota cities el oh curse eee tee ee naa ad hesadawdceeacans we(1) 
COUNt DIOCKS iN a FIO. oo. eeeeeeseesserececceceeseneeesseresees sum(1) 
Cp, In, mv: copy, lINK OF MOVE ou... ec ccesesssestettereeseeees cp(1) 
DIO SICIVE 2.58. Sessvasecsstiz ters ead iee cues ral Soravined enaed eethosuetaiaes cpio(5) 
CPid: Copy fil€ APCHIVES I oo... ce ceecesessstttettneesseseeeeees cpio(1) 
cpio: format Of CPI AFCHIVE. 0... ee cessesttteeeeeeseesseeees cpio(5) 
CRADS® i jacaascat ce raateunctntian. sumewsb iad casdacnsacacstaneneuaa sedan alone’: craps(6) 
Craps: the game Of CrapS. ............ ce ececssssesessssettseeeeeesessenes craps(6) 
crash: examine system image. ............. ces ceeseeeeeeeeeeseees crash(1M) 
Creat: Create a NEW fil€ OF ..............cccccscesscsesscessececececeeeeeeseees creat(2) 
create a name for a tOMPOFALy ...... cee ccecsteccetereeeeenees tmpnam(3S) 
Create a NeW file OF FEWTITE .............. ce eesseeeseeececceceseesseseseeees creat(2) 
CFEAtE A MEW PFOCE’SS. ...... ce ciccsssssesesecssssssetssssseseseeeeeseeeeerens fork(2) 
Create a tags Me cissici a ciasicc scagecctescasvnvscviatisteserecaestveleceia et ctags(1) 
Create a teMporary fil€. 0.0... ceescccsstesccessreececsssseneseesns tmpfile(3S) 
create an error Message fil€ Dy 00.0... ectttceeeeeeeeeeees mkstr(1) 
Create AN INTEFPFOCESS .............cceeseeeccecceeessssssenerececcceeeeeceeeees pipe(2) 
create and administer SCCS .......... ee Seateas adaiatee tease admin(1) 
CRO ATOM ASK eas sipastschereietsccasyceysatanssesszsussestaseovnetusmnestecees umask(2) 
Cref: MAKE CrOSS—FEfEFENCE 0.0... cescessessssrsserenseceeceeeesesenees cref(1) 
CIFON: CIOCK GACMON. 0......... cc cceeccecsssseeeestsseesesssseceesesssaeesenees cron(1M) 
Cross reference fOr Cou... ee eecccssssstceecessrsteeeeeseeseesstaneecess xref(1) 
ChOsS=reference lISTING: ss ssscecissivic sssitseseceectsadedsaeasticesadessnses cref(1) 
CRT VIGWING) 25iivsceticoiovenstadintte inversion tay eenanaseniies more(1) 
CIYPt: ENCOME/ECOdE). oo... cece cccceccsecsercesssseceesestsseseseesnees crypt(1) 
crypt, setkey, encrypt: DES ou... cceseccseseesssseeesesseeens crypt(3C) 
csh: a shell with C-like syntax. 0... ee cseeessseeeeeseeeens csh(1) 
CSplit: CONTOXE SDE. - tcc. veccccieaisie tenes ccoscadcactesineaeccnnneaseananssendents csplit(1) 
Cle Call tOrnih all: tasccieesicdcs cocteadedeousdaers chontutatgnchvoseavexeieadsabantorss ct(1C) 
Ctags: Create a tagS fIIO. ow... cccsssecesssssteecersssteeeesseees ctags(1) 
Ctermid: generate file NAME 0.0.0.0... eccsetceteseeseeectseteeees ctermid(3S) 
Ctime, localtime, GMTIME, 2.0.0... cee ecccsececsssccesstesesssneeseneeens ctime(3C) 
cu: call another UNIX SyStOM. 0.0... ecssseeceseneeseeesnees cu(1C) 
CUDICH TIC 1A = 106s <n dccraiavcsstti ss cciehaswoccsesessatenes geste eonssaneeniien ttt(6) 
current SCCS file Editing ........... ccc cccccccessteseccssssteeseesserees sact(1) 
CUICOE INI siisecotdesscsighoalocirupesnsdias aatecyn esdeasaurasettoncstecacedeonies uname(1) 
Current UNIX SYSTEM. 20... cccesttrcccesserteeceeceeseeeserenseeees uname(2) 
CUrSe@S: SCTEEN FUNCTIONS WITH 000... ccttsetesseeeeeeeeneees curses(3C) | 
CUIFSOF MOTION CUISES: ...........ccccsscesssecsceesssccssseceessecesseesnees curses(3C) 
UTS scsi sa esereg seach cosa ea cade easy asin Senate ens eceeuwaceaneaeels spline(1G) 
cuserid: character login MAME .............ccseecestcecessteecenseneens cuserid(3S) 
cut: cut out selected fields 0.0.0... cccsegeessceceesesseeenesenees cut(1) 
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each line of a file. cut: cut out selected fields of ................. a sesbbaleueuise sateasatausmeneniaies cut(1) 
constant-width text for/ CW, CHECKCW: PrePAPe .........cccessreseessteeeretssereceeesrnenreaeass cw(1) 
CLON: CIOCK GACMON. 0..........ccssccccccccssssscevsneesevesseseseceessssnaeenaaenesceeceeeeeeeens cron(1M) 
EHPAEMON: E|rror—lOGGING DAEMON. ........csseeereseerenersesrereeeeeesenesseteseenereetertesesstereets errdemon(1M) ne 
Ipd: line printer GACMON. oo... ceeeseeeneeeeesterseesessnsteceesessneseteteenenenssenseseetess Ipd(1c) 
terminate the error—logging GAEMON. EFTSTOP: .........ccceeereteetteettestteeteettestteseeesererens errstop(1M) 
runacct: rUN dally ACCOUNTING. 0.0.0... ccceseetenetseteeteerecesensseteeraeeseesenaeens runacct(1M) 
backup. filesave, tapesave: daily/weekly UNIX file SYSt@IM ............ cc eetteseerseseeees filesave(8) 
/nandle special functions of DASI 300 and 300s terminals. ............ccscceseeseererseeeeees 300(1) 
special functions of the DAS! 450 terminal. handle ..........ecsceseeereretetereteseres 450(1) 
prof: display profile Gata. ..........scccessscseerseseenseesecsssesstssessnensesseneneneeraeseereneeeees prof(1) 
termcap: terminal capability ata DaSC. ......... ce seetssteteteseesetetensetenerereeeetsrsssesseseesees termcap(5) 
port ttytype: data base of terminal types Dy ............ cesses teeeeteees ttytype(5) 
call. stat: data returned by stat SYSIOM ..........c. cece eeeteeeereseesseeeees stat(7) 
brk, sbrk: change data segment space allocation. ...........cccceesrerteeteteens brk(2) 
types: primitive system data tyPeS. ....... essences teneenereseresseteceees types(7) 
join: relational database Operator, ............scsreressesreerereeceeretessereseenees join(1) 
date: print and set the date. oo... ccssssnsesseetsnessnssesessststseresesesesensenetestetsaeeentes date(1) 
/asctime, tzset: convert date and time to ASCII. .........ccccscssersrereeteecssreessteenensees ctime(3C) 
date: print and set the date. ........ccscssrseereessetserssesetsens date(1) 
AC: desk Calculator. .........scsccssscsssccesesecsssscecrsserstasssssnsnaeees dc(1) 
dconfig: configure logical GISKS. .........cssscsesecsseeeesseensees dconfig(8) 
dd: convert and Copy a fil€. 0.0... cee csceteeteteessnerettersereeees dd(1) 
AUD: GODUGGET. ......... ees etccssseestrenssessscenenessaerseeeesseseeseeseeetens adb(1) 
fsdb: file System GEDUGGES. ..........ccecsesesetsceeneetetsenseetseessstestansessseesesssseneees fsdb(1M) 
for accounting. define holidays and prime thMe ........... cece seseessesesreessenreens holidays(5) 
gettytab: defining speed tables for getty. ..........esecseseseseeeserrenes gettytab(8) 
-eqnchar: special character definitions for EQN AN NEN. ..........cceneneeerereretetsees eqnchar(7) 
usage of mm macros and eqn delimiters. MMCHEK: CHECK ............ceeseeseseseeesetetereeeeens mmchek(1) 
names. basename, dirname: deliver portions Of Pati ...........cccceceeeesrccnseeeeseneeestteeeeees basename(1) 
file. tail: deliver the last part Of @ ........ ce ccceeterseressntneeeeeeeesenerees tail(1) 
delta commentary of an SCCS delta. cde: CHANGE thE 0... ees cneteetseeresetseseeseeetsesnentens cde(1) 
file. delta: make a_ delta (change) to an SCCS oo... eccctcssceteeceteeteeetteeeneens delta(1) 
delta. cdc: change the delta commentary of AN SCCS 0... eee eeesesesteeeennenens cde(1) 
rmdel: remove a delta from an SCCS fil. on. eeccssesteenseetteeteneeseresesoonaes rmdel(1) 
to an SCCS file. delta: make a delta (Change) 0.0.0... cccecessesseeteesteeteees delta(1) 
COMD: COMbING SCCS e/MA|S. .........c cee cssssscereceseetestseeresesecssesceseeessssesneeseeessnnesenetens comb(1) 
MESG: Permit Or CENMy MESSAGES. .......... cc cccrrceestetseerseesteestsetseseteeneenseseneees mesg(1) 
tol, and eqn constructs. deroff: remove Mroff/troff, 0... eseseeeeteeeetreeseetsetseeseeseeenens deroff(1) 
crypt, setkey, encrypt: DES encryption. ..........cccsscssesseereesterseerscseeseenseestsnnseesees crypt(3C) 
Close: CloSE A fIIE GESCTIPIOL. .......... ce eececcsssetscetseetseceseeesteenenreeserneasereeeseeesenes close(2) 
dup: duplicate an Open file GESCTIPLOF. .............cccesereseseeeteeeseeseeesssseeeceereensenseeseeneenes dup(2) 
dio: desk Calculator. 0.0.0.0... cccscsssscsscssstenssssccesscsssssssnseesssseeserees dc(1) 
file. access: determine accessibility Of 2 0.0... eect csseeesteeerneeenenes access(2) 
fille: determine file tyPO. 0.0... ccc ccscctcseeeeetseeesereereseesenteeeee file(1) 
IOC CONVO! SCOVICE <2 iscescdccscsecessias aha wiiniacipcerquasniningsnccunsostensedineterarstbazcrease iocti(2) 
master: master device information table. .............. cesses cessneseeesreeseeteaees master(5) 
liomem: local device VO MEMOPY ...........ccccccessesssetsestenrsscessesesseeeseeeesees mem(4) 
devnm: device name. ......... Coe Se ade dosticts icaaa user ebianae eames tnce nares devnm(1M) 
CGEVNM: GEVICE NAME. ..........cccssccccssssssstecesesesssetssteeeeseeevonees devnm(1M) 
blocks. df: report number Of free@ ISK ............cceccerseestesteesteereeeeees df(1) 
Gformat: disk formatter. ...........:cccscsccsesssssteresessstessoesseeeesones dformat(8) 
the Network Operating System/ D-hosts: configuration file fr 0.0... cseeteeeeeeereereeneenes D-hosts(5) 
ratfor: rational Fortran dialect. ..............ccccccccscsssscccsssssssscssssssscessssssesesssessecesssaseeeeeeneees ratfor(1) 
interactive thesaurus for diction Explain: ............. ce cssscesesestecessreescessteceessseeesentaeaes diction(1) 
diction: print Wordy SENTENCES ........... cs ceeceeeeseeteeeeetecees diction(1) 
BG? DIG, HIN. eset savcctacecinicnssuelcon tater siutavs soutiuiedeesceewe sates cqavankedeeaedonts Geeeeions bdiff(1) 
comparator. diff: differential file .............. cc cssestesteeteesteetercseesseseeesseneenenes diff(1) 
comparison. diff: 3-way differential file 0.0.0... etetteeteeeteetsenerens diff3(1) 
sdiff: side-by-side difference Program. .............cecscsessseetseteereeeeeteenesoneaeeees sdiff(1) 
diffmk: mark differences between fileS. 0.0.0.0... cccsseeeceessereeerrersees diffmk(1) 
diff: differential file COMpPArAtOL. 2.0.0... cesses cree eeeeeeeseeeteenenee Giff(1) 
diff8: 3-way differential file COMPALISON. ...........ccccseccesteetteettneesteneteetees diff3(1) 
between files. diffrmk: mark iMErENCES ......... eset teereetsetseeteenetees diffmk(1) 
dir: format Of directOrieS. ........... ccc cccsssssesereeeees aeeaereetonus dir(5) 
dircmp: directory COMPALISON. ...........cccceseccessscssteeneteeenaes dircmp(1) 
Gir: format Of directories. ooo... cecstccccccceceeesceeseceesecessceeeesseeeaeeneeeeeenes dir(5) 
Is: list CoNteENtS Of irECtOFieS. 0.0... cece ccceeetesesserteceessssaesssecesenssssaeeseseeereesenes Is(1) 
rm, rmdir: remove files OF ireCtOFIOS. oo... cece sesssesesscscsesscssssseecteceecceseceaeseeseeesenseeees rm(1) 
openup: keep open key directories and fIIOS. ..........ccecscesssessesteesresteeetreerseeseneecenens openup(1) 
bis: list contents Of dIFECtOIY. ...........ccccsseccccsssseseceseeeeeesessscecesseseesesessaeeeeeesensees bis(1) 
Cd: Change working direCtOry. 0... ceesstseeteetesessssnstseeeeeeeercneeeeeteenreneseaeeaey cd(1) 
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chdir: change working 
chroot: change root 

mkdir: make a 

“mvdir: move a 

uuclean: uucp spool 

dircmp: 

unlink: remove 

chroot: change root 

pwd: working. 

ordinary file. mknod: make a 
mount a remote file system 
unmount a remote file system 
path names. basename, 
node: enable or 

acct: enable or 

df: report number of free 

is: iSBC 

pd: IMSC 

dk: pseudo 

dformat: 

du: summarize 

dconfig: configure logical 
mount, umount: mount and 
rmount, rumount: mount and 
vi: screen-oriented 

prof: 

hypot: Euclidean 


surface characteristics of a 
MM macros. mm: print out 
macro package for formatting 
slides. mmt, mvt: typeset 
whodo: who is 

dnid: 

graph: 

arithmetic: provide 

rm: Cipher Microstreamer tape 
dk: pseudo disk 

mt: pseudo tape 

trace: event-—tracing 

make a new nroff terminal/printer 


dump: incremental file system 
od: octal 

extract error records from 
format. 

dump. 

print the names of files on a 
dump: incremental 

on a dump tape. 

descriptor. 

descriptor. dup: 

echo: 


program. end, etext, 

ex editor for new or casual/ 
sact: print current SCCS file 
ed: text 

ex: text 

Id: tink 

sed: stream 

vi: screen-oriented display 
/text editor, variant of the ex 
for new or casual/ edit: text 
/user, real group, and 

and/ /getegid: get real user, 
Language. 

for a pattern. grep, 

node: 


Plexus Sys3 UNIX 


Permuted Index 


ONO CHONG css Ass wssewandhctiied teal aiacbee des bduatatee ee acouasieawseaccxessuaes chdir(2) 
CIFBCIORY <- nitivica cs occnesrncensas aus tanilad ecitasesatasaeea mie aimee chroot(2) 
CIR CION Yo cecsesieceigs ns Be eras acess eaves Sines seee ee eden eansaeeesseaeeees mkdir(1) 
IQ CUOIY sc icas red teuvevee Gacagsededcictentsh caphaassedncescaaciaesanaeeaimennee mvdir(1M) 
GIROCIOFY: Cl AN UD avis cdesexaceecstievtistertenresvesint esovsacsieeasae wens uuclean(1M) 
GirectOry COMPALISOM. ...........:.ccccccsssssscecsessseecsesseececsesesesseeees diremp(1) 
GIFECIONY QIAN Y sesso cascecccuo us cacicdscusiesctiucssaas esadeetiassentecteucwesuentes unlink(2) 
directory for @ COMMANG., ............cccssscccsssecsesscesssssreescsssterseees chroot(1M) 
GIFECIONY: NAITO a scie hisses sk diecast dagitinbereeedeer ae alimaiiee pwd(1) 
directory; OF 2 SPOCIAl OF iisssssececieseciicasessocatiascdesccseseneeutadecs mknod(2) 
GIFECIOLY <FIMOUINS Sosciaciesioncnadh astiiccsteacestiacseasecentendeadoven ener: rmount(2) 
GIFECIOFY: PUMOUI: icovcicssecdicieciicsssecsacietenncvativivendeeiccavscasssnesses rumount(2) 
dirname: deliver Portions Of .............s:ssscccccsssescersscescceceessvees basename(1) 
disable foreign NOSts .............ccccccccssssssccrsesssssrssseeseccessessseees node(1M) 
disable Process ACCOUNTING. ...............ccsssssececessssssteteesecseeeees acct(2) 
CISK: DIOCKS: osealeccectiseccteicenccinsccaterante otieexiatecnabemueacnndietens df(1) 
Gisk COMMMOMO | ss sisis235 tosses cies ocieoeucedacsevedveensausesssoieasaamuneias is(4) 
GISK COMMEONG. ciccncenheeteai iced ccyarepecay ivseauseecicuneeeaiatacantates pd(4) 
GISK GHVGE . eccucioroncscnc eticacduasceetiaussacutaveteevessaranemaengneaeuG dk(4) 
CISK: TOMIMANO F555. 55 coe ccusssscndsdetie atctn hes dgeedsiareadeatseureiabereewieees dformat(8) 
GISK US AGG es: sscedescciisctsentscde she suaecancuusted daccasbtadardiestertiavinteecesens du(1) 
ISHS igs cra sitios cassette artnscin teense eeeneadadseuheibaaeueviae Meoteedsaeetuneeas dconfig(8) 
GISMOUNT fIIE SYSTEM, ..............sssssssessscsescesssscsessccescosssscceeeees mount(1M) 
dismount remote file system ...... GuiedatedecetcuavasseeovecetweuMinceiseas rmount(1) 
display editor DASE OM OX. 0... ccscsetesestccnssessssesecctsesetees vi(1) 
Gisplay profile data. ...............cccccccccssscscssessssssssssssnesssesessesseees prof(1) 
GISIANCO eden vaclccctitncian tenia cheese cd suicsess eesectesndeeeeacelevameeeiiese hypot(3M) 
Gk: pSeudO ISK IVE. ...............cscssscsscececesessecseesseceeceseeseseees dk(4) 
dnid: download program fileS. 0.0.0.0... ccsssssereecseesssseeneeees dnid(1m) 
document style: amalyZe@ ...............cceessccccssesscenerrrsecececceecesess style(1) 
documents formatted With the ..0..... ce ssstseesssereeeeestaees mm(1) 
documents. MM: the MM. ...............:cccccccssstersescsesessssesereeees mm(7) 
documents, View graphs, ANA ............cssercsssrrecesstrscesessees mmt(1) 
COIND WAL: iaicncctreicilesoomtautesauiumccomndamiianee whodo(1M) 
Gownload program fil€S. 2.0.0... tssesceccssssssserteeeceeccesesserens dnid(1m) 
PAW GNA asics dee ec ores seeces Acctecan sertaceastoueaveasistaae graph(1G) 
rill in MNUMbE|r FACTS. .............cesssseccccsssrrrecesesensscsevsssseeaceeses arithmetic(6) 
OIG 5 oh vse cceaetancent vans semi cunetuddetaanpaste vacssauesaweaiasiecsberenaentaaek rm(4) 
VE sseseesta sii deisel oni aes anasin eaiiacicinicaorisdevn se oainateehs dk(4) 
OVO ss coca sas Avast cas iaien sie watastasaceusaawies ieta\ estouetsavondenantereinees mt(4) 
GUIVOM,, Sicesees serene ru spetei re vareucraicn wean dedaunes vou vaneeececdeeuiieuss buaseiedaes: trace(4) 
Griver table trmtab: ................cccccsssssssssssessctsnsscsssentsccssseseeees trmtab(1) 
du: summariZe disk USAGE. ................cssessecsssssssssesccccceeeeesees du(1) 
UII cintasnacsxnowenrsisiisie seve Macsacasvagusesessgveccr aioe eies ious aeagoees dump(1M) 
CUP EV A ca eat Salat ai ceaaies iin ca aes shen satan du acauauzesostoeeeictateawtaseess od(1) 
GUM CICA ieioaceticvasssccauasgcaheianvaendendsduen dodvaesasteteszessiens errdead(1M) 
dump: incremental GUMP tape .............. sce secsseessrcessteeessees dump(5) 
dump: incremental file SySteOM ................cccsssssssssssssesessessseeee dump(1M) 
GUMP tape. GUMPAIE: ................seccesssrceessteesscsrecessessnesessseses dumpdir(1m) 
GUMP tape formal. ..................cccsssssseecsssscsssssssserscesecesssseessenes dump(5) 
dumpdir: print the names of filOS 0.0.0.0... ct tteteerteeeees dumpdir(1m) 
dup: duplicate an open file ................... piceshugerecuassmaenttnitass dup(2) 
duplicate an Open file .................cccsscscssssscscscesssesssecsenseeees dup(2) 
ECNO AFGUMEMTS. ...............ccccccsessssssscsccscssssscenssesevesssesssssceeees echo(1) 
ECHO: ECHO APGUMENMS. ..............sssecccccsssssscrserecerscsnssssseesasess echo(1) 
ecvt, fcvt: OutpUt CONVETSION. ..............cc:cccssssccssccssetcsessssnsees ecvt(3C) 
OO TEX! GOOF veces cscacssssncrcheatelicvnediescensstvsstesessetaeneteeavenceass ed(1) 
Edata: last locations IN ..............cccsssssessssecsscssccssnsseccsscsteees end(3C) 
edit: text editor, Variant Of the ......... ee ccssetceessrececsesstenees edit(1) 
SCID ACU Y oo xcccsoasohe, caster crrnccieteeetetcieadeyscesavdetaecateceawecdiaces sact(1) 
= [8 || 10] Pre ny eee ee en Ree nee ere ed(1) 
CONOR, as sisawnsdovecasvenseoesicvssius inal ocateapeacaraciinotestons nesses: ex(1) 
QMO MS ssc25 ccpcsin sors tah shenvsuawsaneeesageaatecas aedsaeausea noes dessasinnacndsevcicont Id(1) 
= [6 || (| gaan iieseuicebce wey daavenetadiadedoiiisGyeuineena bi eeaiene omens sed(1) 
Editor DASEM ON OX. oo... ....ecccessssesecreecsessonsssscesoees adaenudenadaians vi(1) 
editor for new Or CaSUAl USEFS. .............ccccessccstecesrreesteeecceens edit(1) 
editor, variant of the OX OIOF ......... cece cccessecsstcceseessecees edit(1) 
OffECtiVE: Group IDS ssc ceciacas havchiscadecsaveca sian vedteastnaseonatensons bes getuid(2) 
effective User, real GrOUP, .............ccssscceccessssecsssessesercceeecenens getuid(2) 
eff: Extended Fortran ooo... ccccsssssscceesesscecseesscssesssssssses efi(1) 
egrep, fgrep: search a fi oo... eccecccecscessccecsceceseeees grep(1) 
enable or disable foreign hosts ...............ccccsccscsesssrssscsceeres node(1M) 
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accounting. acct: 

Crypt: 

crypt, setkey, 

crypt, setkey, encrypt: DES 

_ makekey: generate 
locations in program. 
/getgrgid, getgrnam, setgrent, 
/getpwuid, getpwnam, setpwent, 
nlist: get 

man: print 

man: macros for formatting 
putpwent: write password file 
unlink: remove directory 
utmp, wimp: utmp and wtmp 
endgrent: get group file 
endpwent: get password file 
rje: RJE (Remote Job 

~ command execution. 


environ: user 

printenv: print out the 

profile: setting up an 

execution. env: set 

getenv: value for 

character definitions for 

remove nroff/troff, tbl, and 
check usage of mm macros and 
mathematical text for nroff/ 
definitions for eqn and neqn. 


from dump. 

daemon. 

format. 

perror, syS_erriist, sys_nerr, 
the C source. mkstr: create an 
sys_nerr, errno: system 

to system calls and 
errdead: extract 

errfile: 

errdemon: 

errstop: terminate the 

err: 

process a report of logged 
spellout: find spelling 

find possible typographical 
logged errors. 
error-logging daemon. 
setmnt: 

In program. end, 

hypot: 

expression. expr: 

test: condition 

| trace: 
edit: text editor, variant of the 


display editor based on 

crash: 

reading or/ locking: provide 
execip, execvp: execute a/ 
execvp: execute/ execl, execv, 
execi, execv, execie, execve, 
execve, execip, execvp: 
construct argument list(s) and 
uux: unix to unix command 

set environment for command 
sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a/ execl, 
execute/ execi, execv, execie, 
/execv, execle, execve, execip, 
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EeNable or disable PrOCeSsS ..........scscsccccscssseecssssseeesesseeessseens acct(2) 
GNCORE/ASCONO: 6 craw hatceiiiiccentstanwraes iia wanes crypt(1) 
ENcrypt: DES ENcryption. ........ cc cccesccsssesccsesessesssessreseeeees crypt(3C) 
ORCL DUONNS. cceccedcsecscctarnchtacvancosacsereeenesisy nce enasarestvereneaancustae’ crypt(3C) 
GNCHY DHON: KEY 5. cecasccvsscesscacascawachosnssneeiecsnsiensgsteuvenndecebocsansenens makekey(8) 
ONd, etext, Sdata: laSt ........ ce cceseseseecserteetsesetenseeseesesens end(3C) 
endgrent: get Group fIO/ 0.0... ecceceteeereeessseesstesseseneees getgrent(3C) 
endpwent: get password filO/ ............. ccc ssenneseseseeesreoenees getpwent(3C) 
Entries from Name list. ..........cssscccssssssssscesscsesssserertsceteeseaes nlist(3C) 
entries In this MANUAl,. ............cc. see esseesceteeeeteeecennsseeeeseseeoens man(1) 
entries in this MANUAl. ............... cc cecsserseeeerssteceeeesesseesseneees man(7) 
COU. ies iii eiceanisens heroes putpwent(3C) 
OMI 5 seas sessed ilacesslocassiacaetotiicatasaaescseesduasceesdianstedes seats beeeteceet unlink(2) 
ONY TONAL scar Sicasincs iid wssarmiaicionntorraaa aterm utmp(5) 
Entry. /GetgrnaM, SETOTENE, 0.0.0... cece essessrecteesteeseeeees getgrent(3C) 
entry. /getpwnam, SetpWeNt, .............. cee ecseresseeeeteerseeens getpwent(3C) 
ENtry) 10 1B: sciciicenceinarcinrnaonuendeinatennscm rje(8) 
ENV: SEt ENVIFONMENE FOF ..........ce ce ecceccccttceeeccecseceeeeeseseseseees . env(1) 
ENVITFON: USEF ENVIFONMENE, .............. ceccerersccceecsereersorerserenss environ(7) 
ONVIFOMIMGIL <i ncsscasietncaiareea vids Fowvenes ei cossengecrabiesicriinesvesie ae environ(7) 
ONVITOAMEM scores ncsiatesinde ccnsactntervaniaccestcesearniabaceenaeesteen ecieats printenv(1) 
environment at lOGiN tiME. ........... ce cesses cesseerevserenseseesoees profile(5) 
environment for COMMANG| ...............ccsssccessssseesessesoeseesenes env(1) 
ENVIFONMENE NAMB. ........cccccccccscssscesssssssecsseessesaesseeceseesssenaeees getenv(3C) 
EQN ANd NEGN. /SPECial ..........ceecceseesserseecssseevsseseeesseesees eqnchar(7) 
EQN CONSTHFUCTS. DerOff: ou... ce cseecstesetscereeestesessessssersseees deroff(1) 
EQN delimiters. MMCNEK: 0.0... cseccsseeeersesecsssstssereeseseees mmchek(1) 
eqn, neqn, checked: format ...............:ccesseseeesssetenseseeeees eqn(1) 
eqnchar: special Character ..............cccscsecsseccsseesessesseesesees eqnchar(7) 
Orr: error—logging interface. ............ceescccesseresessseeseseeeorenes err(4) 
errdead: extract ErrOr FOCOFdS ........ ec ecseeceteesescestssenesseesenes errdead(1M) 
CPPGEMON: ESFOF—lOGGING .........csccssssreceesesescessesesseseeessereasons errdemon(1M) 
BITTIIO: CTTOT—IOG WG viscascccasesdscssdencdecesansiehasercasessctecnesadeasasuces errfile(5) 
EFINO: SYSTEM EOF MESSAGES. ..........cecccsecssceseseetseeserenes perror(3C) 
error message file by massaging ...............ccceccessceersseeteees mkstr(1) 
error Messages. /SyS_EMrlist, .............cceeccesectreeeeseeseteees perror(3C) 
error numbers. /introduction ........ sesptiesavestassilpnes sea tanuicantabes intro(2) 
error records from CGUMP. ........cccccssccccsscsseerscseesensseenseeeseeaes errdead(1M) 
GHTOP—lOG file TOMM AL. sts nicsisac essa cases sidhe ovale tcnaidntere caviowercevenaecs errfile(5) 
SFOF—lIOGGING GASMOMN. ...........ccccsescessscssescescseseescssseesesnereess errdemon(1M) 
CPPOF—lOGGING GACMON, ............sccssrevecoeseervesscsseteeseeesenseres errstop(1M) 
Orror—lOGGiNng INtEACE. ..............ccecccsserssscessccetscessrsseseeseesenss err(4) 
GITORG : OOO: asec ticiises cdansspec ae dvcvenrica uses tonpesentdeaaiguade esaansbavantos errpt(1M) 
GITOMS., SPN SDOMIN,: iccicvscivccesessinscescecesseessnencevesseevisonsacesensors spell(1) 
TOPS. TYPO 2. esses ins sices en saciawssn ca laganesuvominbinaecepsseensevmucteausenss typo(1) 
EPPt: PFOCESS 2 FEPOFt OF ............ccscsecsssecnscestsccersceteeeereenses errpt(1M) 
EPrstop: terMinate the ..........csscccccccscsssecceresenseesetessteeseeess errstop(1M) 
establish mittab table. 0.0.0... cccesseseccetsersccsssessstensseseeeoes setmnt(1M) 
etext, edata: last LOCATIONS ............ cc ceeesccsreecesesseessseseees end(3C) 
Euclidean Gistance. ..........cccccscssscsssrccsseccseessesseesscnecsseeeseeees hypot(3M) 
QVAIUALE APGUMENTS AS AM 1... eccsessecesreseeveneeenssreessenees expr(1) 
evaluation command. ....... GsdeTeaGoliateseetecuiuneed nics ae en eres test(1) 
EVOEN-1FACING AVIVEL. oo... cescessscercescsecseserssercnereeeseeescsreeesseres trace(4) 
eX editor for NOW OF CASUAW 0.0.0... csecserssersesestseessseeteeeces edit(1) 
OX: text OGIOL. naxicissiietnn inert asceipeenine ex(1) 
OX. Vis SCTEON—OFOMEM™ ........cecseccscssrscscteessstecsssesessresseenes vi(1) 
EXAMINE SYStOM IMAGES. ...........srcsseessecerscreresererseeseeesesess crash(1M) 
EXCIUSIVE fIIE FEGIOMS FOF ........cccsscccsscrrsrrerrereeesesetseteseees wo. lockf(2) 
EXEC], EXECV, EXECIO, OXECVE, .........ccscssserrerersecsssecenscssereens exec(2) 
OXECIE, OXECVE, OXECIP, ......cccssscrcreseccsceccorsrrrecssetsceseseenees exec(2) 
EXECID, EXECVP: EXECUTE A/ ou... ccrccccrrccssersscesssecersessereeeees exec(2) 
EXECUtE A filO. /OXECIO, ...........ccseccccccsssssscsreessocsseevecesssesseneees exec(2) 
EXECUTE COMMANG. XAIQS: ...........ccccccrsccesreercessteeseseseneees xargs(1) 
OXOCUNONY iieccosiidvencviicascaisstinccavenenonaiseosens Ushi Sasa deniceemesnweteaates uux(1C) 
OXCCUTON, CIV! sicisccsicesicscasicraseictinnscssncscecensevonvse dansedswenseseonse env(1) 
ExECution for AN INterVal. ...........cccceccscssesssceesessreesserreees sleep(1) 
EXECUTION for Interval. ...........csscccsscscsssesssrecesssnssecssesesseseoes sleep(3C) 
EXECUTION POF. ..........csecsessccsssssscrseesnesseneseneeneneseseeserses monitor(3C) © 
SXECUTION tiMe PrOFilE. 0... crecrrcccccssscsccessecessssestseersseeeeees profil(2) 
OXECV, OXECIE, EXECVE, EXECIP, .........cccccsressscceereeseceseseeeees exec(2) 
OXECVE, EXECID, SXCCVP: .....ccsscrcccersrsccseessrtsecescerereeessesenes exec(2) 
OXECVP: EXECUTE 2 FIO. 00... ccrccsscreccsserscccesesenteetesestereees exec(2) 
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system calls. link, unlink: 
a new file or rewrite an 


exponential, logarithm,/ 
pcat, unpack: compress and 
for diction 

modf: split into mantissa and 
Square/ exp, log, pow, sart: 
expression. 

expr: evaluate arguments as an 
regcmp: regular 

routines. regexp: regular 
regex, regcmp: regular 

efi: 

greek: graphics for the 
dump. errdead: 

to implement shared/ xstr: 
value, floor, ceiling,/ floor, 
true, 

system. fbackup: make a 
abort: generate an |OT 

of a file system. 

a stream. 


ecvt, 

fopen, freopen, 

Status inquiries. ferror, 
fileno: stream status/ 

head: give first 

stream. fclose, 

word from/ getc, getchar, 
Stream. gets, 

pattern. grep, egrep, 

chmod: change mode of 
core: format of core image 
Ctags: create a tags 

dd: convert and copy a 

get: get a version of an SCCS 
group: group 

link: link to a 

mknod: build special 

null: the null 

passwd: password 

prs: print an SCCS 

read: read from 

reform: reformat text 

sccsfile: format of SCCS 
size: size of an object 

sum: sum and count blocks in a 
tmpfile: create a temporary 
val: validate SCCS 

write: write on a 

determine accessibility of a 
times. utime: set 

tar: tape 

cpio: copy 

mkstr: create an error message 
pwck, grpck: password/group 
change owner and group of a 
diff: differential 

diff3: 3--way differential 

fentl: 

font: 

uupick: public UNIX-to-UNIX 
umask: set and get 

fields of each line of a 

a delta (change) to an SCCS 
close: close a 

dup: duplicate an open 


sact: print current SCCS 
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exercise INK AN UNIINK ...............ccccsscssssssessssssetsessrcessceseeees link(1M) 
@XiStINg ONE. Creat: CrEAtE 0.0.0.0... cccccccscccseccesssscccesesccecesssecs creat(2) 
exit: terminate PrOCOSS. ............ccccsescssssssscerscesssssccsssscssrsccess exit(2) 
OXP, 1OG, POW, SOME: ..........ccscccsssscccsssececssecseccessersccscersseseseeces exp(3M) 
Expand fileS. Pack, ..............ccccssccsssscssssssscssssssecsscccsscestesesees pack(1) 
explain: interactive theSaUrUS ..............ccccccsscssssscssetseeseees diction(1) 
EXPONENE. FFEXP, IMEXP, ............cssscessesssscssesssseseesseseseressseeees frexp(3C) 
exponential, logarithm, POWEF, ..............cccssccscssrecsseseeees exp(3M) 
expr: evaluate arguMents aS AN ............cccccccssscsesesssecsesees expr(1) 
OXPFESSION,. 20.0... esescccsssssessseesessssecscsteccessseecersecsseacceeteaers expr(1) 
OXPFESSION COMPIE. 2.00.0... sescssssssscsscsssscstssestcessssesseees regcmp(1) 
expression compile and Math ..............cceccccscccssccsseeeseees regexp(7) 
EXPFESSION COMPIIE/EXECULE. ..............csccserseeesessssssesesesesees regex(3X) 
Extended Fortran Language. ..............ccccsssssesscsccseseee: efi(1) 
extended TTY—37 typ@—DOXx. ooo... ccc sesstscessrecssssreees greek(7) 
extract error reCOrds frOM .............cccccsccscccccsssssssssssssssrsesetaes errdead(1M) 
extract strings from C programs .............ccccsccesssssssssssrsseeees xstr(1) 
fabs, ceil, fmod: absolute .............. ccc ccsscescescessesscseeeeees floor(3M) 
false: provide truth Valu@S. ..............cscssccsesscsscesscssscreseneces true(1) 
fast tape backup Of a flO oo... ec cecssseecceeeectsssesseseereeee foackup(8) 
FAUM. oe eeccetecersstseseessscssecssesssssesccsesssreuusessesssesescassrsaes abort(3C) 
foackup: make a fast tape backup ............ cece ecsceeneeees foackup(8) 
fclose, fflush: Close OF fIUSH ..............ccccsscescssscsssscstsseeceseens fclose(3S) 
FON: FIG COMMPON. ............cecsestecssrcsssssevessecssssersecesssscsetscessnaeenes fenti(2) 
fontl: file CONtrOl OPTIONS. ...........ccccccccecccssscrecscsstsesssssectsaeeees fenti(7) 
fovt: OUTPUT CONVETSION. ..........cccccsssecessessessssssctsessssessessseees ecvt(3C) 
FdOPeN: OPEN a STEAM. .........cecsscessscsssscescsscusseessssesceceveues fopen(3S) 
feof, Clearerr, filenO: StFEAM ...............ccccccesscsessecsesseteceesenes ferror(3S) 
forror, FEOF, ClEAPEMT, ou... et ceccstscesecessesserseeseessesssssseeessecs ferror(3S) 
few lines Of @ SIFEAM. ............cccccsssccevesssssssssscssvessevseceseeessaes head(1) 
fflush: close OF fIUSH a ou... eescssessecssesssreessrrssssesesessseneess fclose(3S) 
fgetc, getw: get Character OF .............ccssccssscstssssreversssssescsees getc(3S) 
fgets: get a StFING FFOM A un... ccstecstseteeseetseseseseecsseseeeece gets(3S) 
fgrep: search a fil@ fOr @ oo... ccsscsssecssesseessssensssecsvesssenes grep(1) 
Li: ee chmod(2) 
Li: ee core(5) 
Li: ee ctags(1) 
Li eee dd(1) 
LU: ee get(1) 
LC: ere group(5) 
FIO. see essecstsesececsessscnscescessssesessseeseesesseseusessesesescnsesensuscees link(2) 
ee mknod(1M) 
|: ce null(4) 
LC: ee passwd(5) 
LC: ee prs(1) 
FIG. oie ececscssscccsssccestscesssnecessessesseesesseescecnscoessssessesssensescueas read(2) 
FIO. ce seeecccesscesssscccsreesssestesssrsecesscecsseeesssssesssescessnseeesscescessnsaees reform(1) 
FIO. eee sccsesssteccesssrensesssessseceecesescenssceeeserseseeseeseseesecenseens sccsfile(5) 
FG. oe ccacesssnssesuceccnsessvssssesscuscscsssussseusssesssssssessnacaaccacecas size(1) 
|: eee sum(1) 
FIG. ees ecccsccsecssesssesesceseecesccsseesseeecsseseesessersesssesessesssescesssees tmpfile(3S) 
FIG. oo ees eesesscssscecssecesssesessssecesssessseeeceereesessssscensuscessusceseseseenees val(1) 
Li: eee write(2) 
FIG. ACCESS: occ ccssssscesstsecsssssecesssseceesceerseceessssecevecaees access(2) 
file acceSS ANd MOIFICATION 00.0.0... ceecccesscsettccestecestaeeeens utime(2) 
FIG APCHIVER. 0.0... ceeecsscccsscccetccssesecsessseetsseseseecesessscesseenees tar(1) 
file archives in ANA OUL. ..............ccccsssesssecersersssccesstecessnesees cpio(1) 
file by massaging the C SOUICE. 0.0... ee eceecttcesecetseseees mkstr(1) 
FIG CRECKELS. ..........:ccssccccssscoesstsesssecssssrsessesseessessecacescssenseans pwck(1M) 
FIO. CROW: 0.0.0... ccsscccsssseseccsssrseccsssssscsessnseesceseeesessesseuaseress chown(2) 
Fil@E COMPALALOL. .............csccccccsssrstecsessstecssestsecsesserscsssessrsesessons Giff(1) 
FIG COMPALISON. 0.0... cccsecessecsseenssssecssceteccsscesesseeseeseesees diff3(1) 
FIG COMMPON, oo... cceecessccsssecctesecsssesessecesscessesserseccesesesenreess fenti(2) 
fil€ CONTFO! OPTIONS. 0.0... cece sssecesscesercsscesceeeescessessesesenes fentl(7) 
FIG COPY. UUTO, ..........cccsssescccsssssccscessreecsesssseccesseceesecsssensesscees uuto(1C) 
file Creation MASK. ............cccccsssseccscsesassssecssrsscssseseusestessssoes umask(2) 
file. Cut: CUT OUT SELECTED 0.00... eeecsssesesstsestseesteseserseesees cut(1) 
file. delta: MAKE .................ccccssscssenssscscecssssctsssessscsstsesseesessees deita(1) 
Li: 9e =f Tota!) (0 | cee close(2) 
fil€ GESCIIPRON. ............cecccccesscscevscscrsnsecsscescerscreecesessersssseseones dup(2) 
file: determine file type. 0.0.0... cs csssccsscecsresesscesseceseseeeeses file(1) 
file editing ACtiVity. ..............cccccccssscsssssssecssersessssesenscsescsseeens sact(1) 
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putpwent: write password 
setgrent, endgrent: get group 
endpwent: get password 
execip, execvp: execute a 

in an object, or other binary, 
grep, egrep, fgrep: search a 
vtconf: configuration 

System/ D-—hosts: configuration 
acct: per-process accounting 
ar: archive 

errfile: error—log 

pnch: 

intro: introduction to 

of the ICP and transfer to a host 
split: split a 

or subsequent lines of one 
or a special or ordinary 
mktemp: make a unique 
ctermid: generate 

one. creat: create a new 
viewing. more: 

Iseek: move read/write 
locking: provide exclusive 
remove a delta from an SCCS 
bfs: big 

two versions of an SCCS 
Stat, fstat: get 

mkfs: construct a 

mount: mount a 

umount: unmount a 
tapesave: daily/weekly UNIX 
and interactive repair. fsck: 
fsdb: 

rmount: mount a remote 
rumount: unmount a remote 
dump: incremental 

make a fast tape backup of a 
volume. 

umount: mount and dismount 
restor: incremental 

mount and dismount remote 
ustat: get 

mnttab: mounted 

fsck. checklist: list of 
voicopy, labelit: copy 

deliver the last part of a 
create a name for a temporary 
and modification times of a 
file: determine 

undo a previous get of an SCCS 
report repeated lines in a 
umask: set 

ferror, feof, clearerr, 

cat: concatenate and print 
cmp: compare two 

cp, In, mv: copy, link or move 
dnid: download program 

find: find 

intro: introduction to special 
pr: print 

sort: sort and/or merge 

what: identify SCCS 

and print process accounting 
merge or add total accounting 
create and administer SCCS 
send, gath: gather 

lines common to two sorted 
mark differences between 
arcv: convert archive 

format specification in text 
dumpdir: print the names of 
keep open key directories and 


March 1984 


TIOLONINY. Sitch cre cctntoin aaah einen putpwent(3C) 

file ENtry. /GQEtQPMAM, .......... ce cecseeerssecsssectsensessseeeseetanseenens getgrent(3C) 

file Entry. /SCTDWENE, 00... ec tetstesseeesetsenseeseeerseetesseereeesens getpwent(3C) 

file. /execv, execie, execve, .............. B cuatasupuensiieawacteia eens exec(2) 

file. /find the printable StringS ...........cccceerecseteeeetteeeeeees strings(1) 

file for & PAtlOMN. oo... cecscesesssrcsteorseeessretsertesssessseseeeones grep(1) 

file for NOS Virtual Terminal .................. ee eer ye viconf(5) 

file’ for the Network Operating ...........cccecceseesseeeetecseneeees D-hosts(5) 

TG TOKMAL 22 feceiaiail io tiapea ade tc onesies aeereceecie eee acct(5) 

file TORMAL. «s.cwence re atasetiapectine eed tuesatousiaaeuanns ar(5) 

MUG FORMAL ensssececteser teaseserieeharivscieandi bananarcccos ua aceon eee errfile(5) 

file format for Card IMAGES. ...........ccccessereesesseesesteeeeneeeeenas pnch(5) 

FUG: TORII ANS oo fisaccssicis wea seanta vac scespate cata tteen eis a tahoe aboe egeeatenneteaas intro(5) 

file. icpdmp: take a COre IMAGE .......... ce seceestceceetteeeesereerens icpodmp(1m) 

TG: INTO DIECOS sixes enciiskicriienss exleatioeiertiitice ee aticnnens split(1) 

file. Aines of Several FICS 0.0... cc cecseecceecereeeeesesseneeeees paste(1) 

file. /MAkE @ GIFECHOTY, 0.0... cesccestceereeesseseeenetseneseeserersneees mknod(2) 

TIS TAINO: seer se a eects ea ee mktemp(3C) 

file name for terminal. ............ccccsseccsssccecsersseessereesceeeesossees ctermid(3S) 

file or rewrite AM EXISTING 0.0... ccsttteesenstteeseeeesereseenes creat(2) 

file perusal filter for CRT ooo... eee cssessecssesceseeerseccseesnseesens more(1) 

TG DONNER saicericteriatingatvetipncis Memimmaanncniaors ast Iseek(2) 

file regions for reading OF/ ...........eccsesessesseseserseesensneesserens lockf(2) 

TGS. CIOL acces ics ssp.ode.ceecins ieiibteushianichece decousebiy es veowluschanesdiaeanss rmdel(1) 

TNO SCENE s sascsadicisseeieresiancasateatecs canis etas dee vices eos ans bfs(1) 

flO: SCCSCIFT: COMPAS oc seccsicisssseeciciesssedsssessciosssscescdceosnns cevese sccsdiff(1) 

THE: STAMIS soc5 crc cciacetice: Sein anerearccesnn tesa ees ates stat(2) 

FIG -SYSIGINNS: sacdiiranicerts catsasareeacestaantaanieneredeuamanacuioneiads mkfs(1M) 

TIE SYSTOIN.  sscee es cite toss ca vsarstce iat haar eieicesingietastansenioneet mount(2) 

HIE SYSIOM fe cvcisnieciaiscninlseieviciinds intial weniesiNeaien umount(2) 

file system backup. filOSAVE, ......... eee cecceseceeseeeenereees filesave(8) 

file system Consistency CHECK 00.0... cece cceteeceneneeeeenees fsck(1M) 

file SysteM GEDUGGET. ............. ee ccceccecesttecceesesteseceensereseees fsdb(1M) 

FIG SYSTEM GITECHOY 0.0... ee es eetecsteceeceensenseeesereesseeaeeeses rmount(2) 

file SYSIOMT GIECHONY ® ssiccciesicssiscssecaasescycaccdansesssenenecgaeisncsesdiies rumount(2) 

TIS SYSIOM GUMDe isc. scbssiscesientassaedaesvecccaddaieinecexdsccasaveseoncnsees dump(1M) 

fil6 SYSTOM. FDACKUP!: 0.0... ce esses csteteeeesreecessteeseeeseveneees foackup(8) 

file system: format Of SYSTEM ......... cece ceessceeeessrenseseeees fs(5) 

flO SYSTEM. “NOUN, veccissedicccscscstscctssdes siactsocseivannaasceescedeccsceasen mount(1M) 

fil SYSTEM FESTOFE. oo... ceeccssecssteeceteseeteeeeeeeeeseeeseeeecsesees restor(1M) 

file SysteM MOUNT, FUMOUNE: .......... ccc ees eeceseseerenenereeeeeees rmount(1) 

file system statistiCS. 00.0... eccsccessccsteereseesseeserseeseneeenes ustat(2) 

FIG SYSIOMNN RADIO: ccssici sicicisecestetesanecedesmerdie danerercceonldeesay evades mnttab(5) 

file SyStOEMS PrOCESSEM DY .......... ee ecesseesseeeceteeseteseeneenenes checklist(5) 

file systems With lab@l/ ......... ccc ecctteececstecessnsensesseseneeeees volcopy(1M) 

NG CAMS saibescacerast atc acsn senate ody de caseaancaatetaavencstu unr atiens tail(1) 

TG AMPNAMN: 2ccise ci cieemeetcminerne aa tmpnam(3S) 

fil. OUCH: UPAate ACCESS ou... cccccssscctterseescsssertesesesseenees touch(1) 

THE: TYVDG 5 ise Saas ta tires Guna tacteas tas os ice os cnceneneta tons toueneonenanonESE file(1) 

THE MING St cians cevgrancasheatrasrsinntcastans alien tanees teenie unget(1) 

PUG UG erctccsirencreseenrcctocanesai deme ghootdaesiste vatinsaetetess uniq(1) 

file~creation MOdE MASK, ...........ccccsccesscccecereseesseeceeseeseeeees umask(1) 

FIMO: STEAM StAtUS/ ...........ccescecsscctsccseserecesrcetessteseneeasens ferror(3S) 

TUS oa eee asiesssces tuacady fap states wana caetets san tannoateceueersauiueeine nesaseesen cat(1) 

MOS so rica csatescnioncscucahe ameated seuaeas dav ndas su cee odetiesbaueutsear ooneewage tesaveeee: cmp(1) 

TQS) shee iujznascnaeaencaucrscuas ast veceabanuntebs sist suninaauestonwte nateeecusaamatatans: cp(1) 

WWOS 5 sctecccanceeaderuceusnensticisvarcavasetine ee nicautaie ation easy Meee eee dnid(1m) 

TUS ccc leshceece ries otetntatea isehacenes ooteehehahadeves aaa tdesnuseuaeaactccioees find(1) 

TUNES: citssicen castors oiayseanecraeascadaow cs eiisuoia oan eed eceesameaeatsdbeunnealoanayat intro(4) 

TWNGS. - cshsfisi cre cavc trace sds feccasue saccayauaaniastanesieaatacesmeassn se oavtons ase en pr(1) 

PIGS: soscsesedrveceedeies tals vdadbie Se@ewirdundsevyacedsudanieunt lc suieateasectems cites sort(1) 

files. ......... UL Syauigcaire wateanidlon deine vw aeosielee ited ate seetactsactanaueeeeduseelneeextentart what(1) 

fIIQ(S). ACCTCOM: SEACH ou... cecceesesssereceeceeecetsctereeseeeeseees acctcom(1) 

files. acctmerg: .............. esas casnehs tae aaa tno seatiadanbcepeaasetecs ayats acctmerg(1M) 

THOS: SIMI: ccisissesrccacnscosetussseenstyaduvesisareleacaversuesancoRitane botie: admin(1) 

files and/or SUDMIt RUE jODS. 0... ee eeecceeeetreeeeeeneeeens send(1C) 

files. COMM: SelECt OF FOJOCT ......... ce cceeeseseetceeeeserstenaess comm(1) 

TUES CITING | cis di cet ancaie cha nsuabe anna cuncu deste sess tata see diffmk(1) 

files from: PDP 210-10) sce cciasiissinsiecescicietiendaccatocesiene aces arcv(1) 

MOS: ISHOC? ciciesiasrnscneeereeviness sesh sidase GaveRia ds aseensiaaaa fspec(5) 

filCS ON @ GUMP taPe. ......... ce eeceessstecceesserteneeeeeteeseesnaeeners dumpdir(1m) 

NES: QOCNUD: ficinncd tame etireu aionad manent openup(1) 
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rm, rmdir: remove 

/merge same lines of several 
unpack: compress and expand 
daily/weekly UNIX file system/ 
greek: select terminal 

ni: line numbering 

more: file perusal 

‘col: 

tplot: graphics 

find: 


hyphen: 

ttyname, isatty: 

object library. lorder: 
errors. typo: 

spell, speilin, spellout: 
object, or other/ strings: 
fish: the game of 


tee: pipe 

/ceil, fmod: absolute value, 
absolute value, floor,/ 
fclose, fflush: close or 
ceiling,/ floor, fabs, ceil, 
stream. 

node: enable or disable 


ar: archive file 

arcv6: convert archives to new 
dump: incremental dump tape 
errfile: error—log file 

tp: magnetic tape 
per-—process accounting file 
from PDP-11 to VAX-11/780 
pnch: file 

nroff or/ eqn, neqn, checkeq: 
inode: 

core: 

cpio: 

dir: 

sccsfile: 

file system: 

files. fspec: 

troff. tbl: 

troff, nroff: typeset or 

wtmp: utmp and wtmp entry 
intro: introduction to file 
scanf, fscanf, sscanf: 

mm: print out documents 
dformat: disk 

fprintf, sprintf: output 

mm: the MM macro package for 
manual. man: macros for 
ms: macros for 

ratfor: rational 

efl: Extended 

formatters. printf, 

word on a/ pute, putchar, 
stream. puts, 

input/output. 

df: report number of 
memory allocator. malloc, 
stream. fopen, 

mantissa and exponent. 
gets, fgets: get a string 
rmdel: remove a delta 
getopt: get option letter 
errdead: extract error records 
read: read 

ncheck: generate names 
nlist: get entries 

arcv: convert archive files 
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FI@S OF GIFECTOTIOS. ...............cccccssercssscscsecccessavsscssssssecessssnseees rm(1) 
files or subsequent lines Off .............ccccssescescvstsscsssessseeseesees paste(1) 
HUGS: DACK). DOA 5 c5s 0005 ca! ane A secequrtancecanssccdulesideeaswarcatceoness pack(1) 
FIIESAVE, TAPESAVE: 0............ceeccccsssssussssssscsccssecesscesnsecssessnseeees filesave(8) 
VUNG Fast ee te atau oserrostaaisdnaalcan cessed aareto detested ee cats ouhue datear greek(1) 
TUMOUs: scasssen oneey sacairtsatensstiaoalai i dpvasseansedcasBecusiveanthemelacemnutin eae ni(1) 
filter for CRT VIOWING. ...............cssccssscesscessesssssseessecseteesensens more(1) 
filter reverse line—-feedS. ..............cccccccssscocsscessecsscsesssseeseees col(1) 
TUES 2 ess lool pte cs eats cece ee den ata ca dts uments tose ayationnees tplot(1G) 
MUNG TOS oy wscostncdse oteiana ieoheceueleelaaseseseuassecuauseseeanerunae reswatvauviens find(1) 
TUNG TUR TUS 5 ie casa cee ase coaetensesds eiaosGiteceadentietianaees find(1) 
find hyphenated Words. .............cccccccccccesssesessssecesteecessereseees hyphen(1) 
find name of a terminal. 00.00... ee cccsccsssececsecsscescsrsscsseesens ttyname(3C) 
find ordering relation for AM .............cccscsssesecsesesssssesssceseeess lorder(1) 
find possible typographical ..0................ccccccesssssssetceessrecseees typo(1) 
find Spelling EFrOrs. 00.0... ceeesccccsssecssceecssseceesscesessecessseceeses spell(1) 
find the printable strings iN AM ou... ccc cesesesssecesteeseseees strings(1) 
MUSE: sie tesa tates te aysica caves tates acnsats acicnaus esdatet esi eaitasctaccn wee uiauten: fish(6) 
fish: the game Of fISH ............ccccscesssccssseesessssssessscccccsseceeeaes fish(6) 
TRUS icsicrtatnsdsnecaretcatdsaataiet alec casananteeutesawnipeminnbeasioanisce ass tee(1) 
floor, CeilINg, TEMAINGEL/ ...............ccecsccessscssssscssseessceseeeceees floor(3M) 
NOOK, TADS; CON, MMOS. s5icsisceessdicavetccaccdeesdsasdedecteoszesacsescen’ floor(3M) 
TGS A SUSAN... eo5ic35 aie cscicessucs ssteantacincias ts cacceaesineaneneeecs: fclose(3S) 
fmod: absolute value, flOOF, ..............ceecssesccsecssssetcrccseeseeees floor(3M) 
fopen, freopen, fdOpeN: OPEN @ ............ccececcccsstccesccseeeseees fopen(3S) 
TOPSIGM NOSIS) 252es ticvsevd-czahsgosniawsiuvescnrcer alias eaacaceeoaeeeuaas node(1M) 
fork: Create A NEW PIOCESS. ...........cccccccccscescscsssssssesseceesseees fork(2) 
VOWEL seta ce snecsden er arehescccenemeatanstcers tassertetaananeiateoaeloant ar(5) 
NONI ALS seatadrct elit cosa hor inadnecrstasasueueatteanicn caveats arcv6(1) 
MOVING. cscs exyiciaties ienndiet snake renenebuad eeaatuisaactss asta tecccemecesciesanedt dump(5) 
NOONAN Sesciscs Sir de cele caster Wctic ten ieo hone ahece ears cee teahceastsh errfile(5) 
VEIN AG 52 psek sees csutad cesqn cross etacdaensasiasacvunaadnumeinueeniue eae eens tp(5) 
TORIVIAL CCE acs ceesatan ao pec aag, Melsute aes iaads oaaudasavodacnaseasircn aie acct(5) - 
format. /convert archive filOS ..............cccccsscesecesseccssessscsceees arcv(1) 
format for Card IMAGES. ..............:cccccssssececssessosssscssesssssssceceres pnch(5) 
format mathematical text fOr ...........cccccscsccsscestscsssscserscsseseees eqn(1) 
format Of AN INOdE. ............csecccssecesrsecsssecccescessessecececceececsces inode(5) 
format of core image file. 0.0... ecesstcessrensessesessececeeees core(5) 
format Of CPlO AFCHIVE. 0.0... eeescssscssseseseessceseecensscesesessesees cpio(5) 
format Of CirectOries. ..............ccssscccssssccssesssscssessseccesssssscceees dir(5) 
format Of SCCS flll€. oo... eeecccsstesssesetssetsessenes iiciaients sccsfile(5) 
format Of SyStOM VOIUME. ..............cccccccccessccccssssecescessersesees fs(5) 
format specification in text .............cccccsccsssscsscssesscesssseeesaces fspec(5) 
format tables for nroff OF... eeccssetcesscccnssssesecsecsessseees tbl(1) 
NOUVEL TOK cs sands ces esssdeusecvasanceesteeetsrime ateeriucpseeaewasaeoes sauce troff(1) 
TOPMAL UNM: ccrssiaieis ste ccayesercotavacinecbauioeeeducc Auusateacs aeede eens: utmp(5) 
formats. ............... sats pa Gaunt esau ape unuua taut Seabubadan dunes vialedsdavealite intro(5) 
formatted input CONVEPSION. ............cccccceccesesescssscsscsscececceecs scanf(3S) 
formatted with the MM MacfS. ............ccccccssesssesesscosees mm(1) 
TORMANON: cisyctacccsaiteavendeni tins dacihstesnavaadinticad vateaeenesmure ees dformat(8) 
formatters. Print, 0.0... cesecsstecesteeesssccssens eetates a eaeeuadecs printf(3S) 
formatting GOCUMENTS. .............ccccssccssceesctsesseccsesesessseseeacees mm(7) 
formatting entries in this ............. ccc cccesscecscessrasesssssseceseeees man(7) 
formatting MANUSCTIPHS. 0.0.0.0... kee cescesseeteteseectseessseoseass ms(7) 
POM CIGIO Che sa2 oso sactsagee acestanran eee iucczsoteniicacoseuetonssavevadvaans ratfor(1) 
Fortran LANQuage. ...........ccccscsssescessseecssesssscssessesecssssesseceees efi(1) 
fprintf, Sprintf: OUTPUT 00.0.0... cccessssccesssterscsssescesesssecesenaas printf(3S) 
fputc, putw: put Character OF 00.0... ccsccccccssscccssssstsceesenes putc(3S) 
fpUts: PUt a SITING ON @ ou... cee ccceecesescecss cccessecerstceceseusers puts(3S) 
fread, fwrite: buffered binary ...............cccccceccesctsccssscseeseseees fread(3S) 
TOG CISK DIOCKS - sesteiin ss sscvteaiunasareasniiuaaceedbsesaneivelededieaded suas df(1) 
free, realloc, CallOC: MAIN ..............cccccccsssssececssecsecesssestececeens mailoc(3C) 
FrEOPEN, FAOPEN: OPEN @ ............cccccsesscccccesssssscceccecerentaceenens fopen(3S) 
frexp, Idexp, MOdf: Split INTO occ ceeeeeeteecesesseceeees frexp(3C) 
6. 2 =) (7 | nr Scania gets(3S) 
from AN SCCS flO. on. ee ceecestovesccssescereecessescesssceeasecnaes rmdel(1) 
TUOPUD AQ 5 ois Slee cate ta eects a et naductean aeaneansseduareataeunnuvins getopt(3C) 
OM QUID s.s0 sa tsisscruetasensnctiatere Grable ectutieen eee) errdead(1M) 
TOU (NG 2 i ciicto cats suas! decscusa cee dtseaeveaised ena secusanirsWie dan ianiceiasiacieeeues read(2) 
FrOM F-NUMDBELS. on... cece ccsseesesnsescsessseecsersecscessessesscessseees ncheck(1M) 
WOM AMG? NSE. yaaa: ciseiseenisirectsteaee decid Geier Aadchiate case nlist(3C) 
from PDP-11 to VAX-~11/780/ .........ccccessccsscssscssecssecsceesevens arcv(1) 
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acctcms: command summary 
getw: get character or word 
getpw: get name 

input conversion. scanf, 

of file systems processed by 
check and interactive repair. 


reposition a stream. 

text files. 

stat, 

stream. fseek, 

gamma: log gamma 

jO. j1, in, yO, y1, yn: bessel 
sinh, cosh, tanh: hyperbolic 
floor, ceiling, remainder 
300, 300s: handle special 
hp: handle special 

terminal. 450: handle special 
logarithm, power, square root 
atan, atan2: trigonometric 
motion curses: screen 
input/output. fread, 

wtmp records. 

moo: guessing 

back: the 

bj: the 

craps: the 

fish: the 

wump: the 

intro: introduction to 
gamma: log 


submit RJE jobs. send, 

jobs. send, gath: 

timex: time a command and 
abort: 

makekey: 

terminal. ctermid: 

ncheck: 

lexical tasks. lex: 

rand, srand: random number 
gets, fgets: 

get: 

ulimit: 

getc, getchar, fgetc, getw: 
nlist: 

umask: set and 

stat, fstat: 

ustat: 

file. 

/getgrnam, setgrent, endgrent: 
getiogin: 

logname: 

getpw: 

system. uname: 

unget: undo a previous 
getopt: 

/getpwnam, setpwent, endpwent: 
- times. times: 

and/ getpid, getpgrp, getppid: 
/geteuid, getgid, getegid: 

tly: 


time: 

get character or word from/ 
character or word from/ getc, 
getuid, geteuid, getgid, 

| name. 

real user, effective/ getuid, 
user,/ getuid, geteuid, 
setgrent, endgrent: get group/ 
endgrent: get group/ getgrent, 
get group/ getgrent, getgrgid, 
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frOM PEF—PFOCESS ACCOUNTING! ........ ccs ecessetssteeerereneees acctcms(1M) 
from stream. /getchar, fGetc, ...........ccceccerssceseessseeseseeees getc(3S) 
TOME ID esse ccestcct ca asanccessen cs vans essateneucsvatseuestieencateentamaneieaiens getpw(3C) 
fscanf, sscanf: formatted .............cccscccsssesscccsstscesssesesseeees scanf(3S) 
(Sk. ChECKISEC USE ii icciiircivcciaitivenenleveereadsoneeeiat checklist(5) 
fsck: file SyStOEM CONSISTENCY 00.0.0... eee eesteeeecestereeeeeeeees fsck(1M) 
fsdb: file system GEDUGGES. ....... esc etessterceesteessneeeees fsdb(1M) 
fs@ek, ftell, OWING: ..............cccccestecstecestcserserseeessesesseeseesaeeees fseek(3S) 
fspec: format Specification i .............ccscccccsccssssceesesstceesseeees fspec(5) 
Stat: Get Tile: StatUS: occ. he cise diicarisee ieee Seecrarecanerseoucers stat(2) 
ftell, rewind: reEPOSitION A oo... cee eseeeeeeteseeeeeseneeseeeeens fseek(3S) 
PINOT ON sicevseescelu ees aioostsrernscin nanos anaueacadensancdccasvend aie eauasanaeaass gamma(3M) 
TUNCTIONS =. ssh seeceacaxeasssssscenecarversxttvcanee ta eater eee bessel(3M) 
HUNICTONNS 522 ec. cree se eloctcsasec asec Sos hesvarn eeaaaseeaaa aw eavede oastnceee sinh(3M) 
functions. /absolute ValUC, ..........c.ccccccccccccerssrsstsccecessessseeeees floor(3M) 
functions of DAS! 300 and S00S/ oo... ce ceseeceneeeeeees 300(1) 
functions Of HP 2640 AMd/ ou... ecsces teteeseesecesensnseneens hp(1) 
functions of the DASI 450.000... ccsssssessssestsecesesessreesenes 450(1) 
functions. /sqrt: ExpONeNtial, 0.0... cesesseteeceessteeeeeeee exp(3M) 
FUNCTIONS. HAN, ASIN, ACOS, 2.0... cece ceessteeeteeeeesaeeeees trig(3M) 
functions with optimal CUISOF .............cccsccescessessrseseesseeseeess curses(3C) 
fwrite: buffered DINArY ou... cecesstcessteeerececsssecssteeeseaseeees fread(3S) 
fwimp, wtmpfix: Manipulate oo... ec eeteeesesttrerenenees fwtmp(1M) 
CIN see cisertea si soteget aks aashecireasieota i sarewrteeecaans ncaa taees moo(6) 
Game Of DACKGAMMON. 00.0.0... ccesscssssrscccssrecsesssteeeeerstaeeees back(6) 
Game Of DIACK JACK. oe ccsssseessestererersreceseeraceeeesssaene bj(6) 
Game Of ClaOS: cess sssisiensesctiseeenesistivinnrcrenca iad cgavneauaannsccs craps(6) 
GAINS OF MM assis locascceescsesveracaseceaned taceascei acest set Vasaubtaestis fish(6) 
game of hUNt-theE-WUMPUS. 0.0... ec cccccertececenereeesesteeeees wump(6) 
DAMGS  rescichceletets boo itead Gasshesneeetnes wie Tepeuclesietadstnaeies intro(6) 
GaMMa MUNCUON: ss ccevinsssseccretesssiceccesideateteaues eeseseativeastintenes gamma(3M) 
Gamma: log Gamma FUNCTION. ......... cece cestcestteeeseeseeseees gamma(3M) 
gath: gather fileS AN/OF 00... ee cccseeterercsseeeeestseeteeeenees send(1C) 
gather files and/or submit RUE ou... ceeeceseseteeeeteeees send(1C) 
generate a SySteM ACtivity/ ou... eee seeetecsesetcesteeeeees timex(1) 
generate an IOT fault. ............ccccsecccssccstcesscestsessseessesserenes abort(3C) 
Generate SNcryption key. 0.0... eccsssccccssscccssssseeessssssseees makekey(8) 
generate file NAME FOF .............cccescssccsscccsterssscereeesesesteceeeees ctermid(3S) 
generate names from i-nUMDbEIS. ............... cc cccesesceeeeeesees ncheck(1M) 
generate programs fOr SIMPIE ou... ce eceeesssseseetsceeesees lex(1) 
OMONANON S sees easseractiedsunvicvi ect casas temerearncieronnummunneds rand(3C) 
Get a string froM a SIFEAM. ou... eecsscetecseceseseeeneceseeeeeees gets(3S) 
get a version of an SCCS fill. one ceseeeeeees Sgteamecedys get(1) 
Get and Set USEF IMIS. 0... ecceecsssccetsesetescstesettsessreeees ulimit(2) 
get character Or WOFrd fFOM/ ...........ceccescetrseesteeteceersesneesees getc(3S) 
get entries from Name list. ...........cccsccssesssccsscesteesssesecsers nlist(3C) 
Get file Creation MASK. ............cccssccccssssssecessesssssssereeessesees umask(2) 
Get NG SlatUS:. Wiccchiceiieninanciiieeienmicenietasus aes stat(2) 
get file System statistics. 0.0.0.0... cccsscelessessssescstrersssrececenes ustat(2) 
get: get a version Of AN SCCOS occ ssssstessessteeseens get(1) 
Get Group file ONY. 0.0... ce ceccsssrtensteessecetsesssetessesesesens getgrent(3C) 
GOt OIA NENG: 6 cise csasvessecccasseesstecseieckasetscesaaeedeeaascenancendess getiogin(3C) 
COE IOGIN NANG iiscccccresteshaisnded Secessdcvnsinelientnran teeesecsiannietiaes logname(1) 
got name trom Ul. ja ciccnndisnusinninaieds getpw(3C) 
get name of current UNIX 000... ccs eccteeseeestereeseenees uname(2) 
get of an SCCS fle. oo. eee Rugsia aetna aesaaaiet unget(1) 
Get Option letter frOM AFQV. oc csceseesseccteserteesteeteeenees getopt(3C) 
get password file ONY. 0.0.0.0... csesseessecctsesecsessessesenees getpwent(3C) 
get process and child ProceSS 0.0.0... ce esscereeseserneesesees times(2) 
Get PFOCESS, PFOCESS GFOUP, ou... csesscesceccssteserescteseteasees getpid(2) 
get real user, Eff6CtiVe USEF! oo... eee ceccsseseeeeseesseneeees getuid(2) 
get the terminal’S NAME. 0.0.0... ce cteeceesscceeesssseeeeesseaseeens tty(1) 
OE TNS ose sta ers este cet ia cea aia sco vk occa pment eet ae aoa aes time(2) 
getc, getchar, fgetc, Getw: ........ cesses soaceeabats oaabaeiues getc(3S) 
getchar, fgetc, GEtW: Get oo... esecterceeteeersesseseeeteneees getc(3S) 
getegid: get real USEF! 200.0... cccssesssssceesscssreecsessteesesssees getuid(2) 
getenv: value for ENvirONMENt ............. ccc cece ceseeereeeeeeees getenv(3C) 
geteuid, getgid, getegid: get 0.0.0... cee ceceseeseesrteeenseees getuid(2) 
getgid, getegid: get real on... ccese ecetteeeesesssereneees getuid(2) 
getgrent, getgrgid, getgrnam, .............cesseccstssstesereeensees getgrent(3C) 
getgrgid, getgrnam, Setgrent, 00.0... eseeesrsecstesseteeees getgrent(3C) 
getgrnam, setgrent, ENdQPENt: ..............ccsecseccsssecesseeesesceees getgrent(3C) 
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argv. 


process group, and/ getpid, 
process, process group, and/ 
group, and/ getpid, getpgrp, 


setpwent, endpwent: get/ 
get/ getpwent, getpwuid, 
endpwent: get/ getpwent, 
a stream. 

defining speed tables for 
terminal. 

for getty. 

getegid: get real user,/ 
from/ getc, getchar, fgetc, 
head: 

convert’ ctime, localtime, 
setimp, longjmp: non-local 
graph: draw a 

sag: system activity 


tplot: 

TTY-37 type-box. greek: 
subroutines. plot: 

plot: 

mvt: typeset documents, view 
macro package for making view 
extended TTY-37 type-box. 


file for a pattern. 

chown, chgrp: change owner or 
newgrp: log in to a new 

/user, effective user, real 
/getppid: get process, process 
group: 

setgrent, endgrent: get 


setpgrp: set process 

setuid, setgid: set user and 
id: print user and 

real group, and effective 
chown: change owner and 
a signal to a process or a 
update, and regenerate 
checkers. pwck, 

ssignal, 

hangman: 

moo: 

DASI 300 and 300s/ 300, 300s: 
the DAS! 450 terminal. 450: 
2640 and 2621-series/ hp: 


nohup: run a command immune to 
stream. 
help: ask for 


accounting. define 

of the ICP and transfer to a 
node: enable or disable foreign 
handle special functions of 

of HP 2640 and 2621-series/ 
wump: the game of 

sinh, cosh, tanh: 


hyphen: find 
rje: RJE (Remote Job Entry) to 
icpdmp: take a core image of the 


Processor. 
/vpmsnap, vpmtrace: load the 
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Permuted Index 


GetloGin: Get ]OGIN MAME. ............cscesscstsessscsevssessssssssesseeces getiogin(3C) 
getopt: get option letter from .............cccsscessscssssscvesseeceseeees getopt(3C) 
getopt: parse COMMAN OPTIONS. 0000.0... ec csessscssesscnecoeeeees getopt(1) 
Qetpass: read a PASSWOTT. ou... cseescsssscsesccssccsssesesaeseees getpass(3C) 
Getpgrp, Getppid: Get PrOCESS, ......... i eccesseesssssesseeseseseeens getpid(2) 
getpid, getpgrp, getppid: Get oon... ccc csscsseeecstescesseeeees getpid(2) 
getppid: get PrOCESS, PFOCESS ............ccceessccessessceessceceeseees getpid(2) 
getpw: get Mame froM UID. oo... cece ceeesscsesseesssesecees getpw(3C) 
getpwent, getpwuid, getpwnaM, ........ cc eccseesstreesteeesees getpwent(3C) 
getpwnam, setpwent, ENdpWeNt: .............cc cc cccccccesseseesseeeeee getpwent(3C) 
getpwuid, getpwnam, setpwent, ................cccccscesssecsessseees getpwent(3C) 
gets, fgets: get a String frOM 0... eee csseseeteeeseseeeneesees gets(3S) 
Get: GONADS sie tertyes Scien taawceneaz ence eds lacds uae crias gettytab(8) 
getty: set the Modes Of @ 00... ecccesssensssssssersceeeeeeeees getty(8) 
gettytab: defining speed tables... cccesssscsscesesssseeees gettytab(8) 
GetUid, GeteUId, GEtGIP, ........... cc eeeessscceessescesssseeeseeesesseeseees getuid(2) 
getw: get Character OF WOFT ...........:cccscesssececssessscestsscetscevens getc(3S) 
give first few lines Of 2 STEAM. 0... cc cccssettecceesstteeenees head(1) 
GMTIME, ASCHIME, TZSEt: .0........ eee eeeesseccessseccesestteecccesssseseess ctime(3C) 
ONO 5 se Pieicccarca nies sboteetee wie oltenadeseeuncciamadsbel auaes Saauedeneueen setimp(3C) 
QR ADI six ccieccesanh oh vache easaeeciueats thawth cassean Rone inncmataoan ua tiaetaats graph(1G) 
CAD Ve cerecaecee aeecel tia ass iabeons ste ewe atcs eiaeeadivead reaniteeetocenate. sag(1M) 
Graph: Graw a Graph. uu... cecessssssecereesssseeeescessessssseeeens graph(1G) 
re L6= 1] 1 o=-3 ||] (= ta ne tplot(1G) 
graphics for the extended 00.0... ccccesssssssscssserseseseeees greek(7) 
Graphics interface ................ ce eescsseseccecceccscsserssseseserensessesesesoes plot(3X) 
QlFADNICS INTIS ACG ci iisxscstiectstunsdenares. ceo ivisaeteeaiekipacravecteasanes plot(5) 
graphs, and slides. MM, .......... ce cccccssssssensereseccesceeeeeeens mmt(1) 
GUADS WV a as secretin ettnonnsara rete venenaeis onGeteesoheydi ss setieden: mv(7) 
OTECK Graphs OK 1G wad ssesssescesoctnsccsvnesenerercecedrantievecacatians greek(7) 
greek: select terminal filter. ............... ee ceccececcceeeeeeeesseeceees greek(1) 
Grep, Egrep, fgrep: SEACH A oon ec cecesssttteterreneseceneres grep(1) 
QIOUD Ss sctanieconiahacates aaaveudsraaeanctetmaciciante ocisausete ontees ance iota chown(1) 
ROU Ds. sasstiesesy os ss snes Sian wutinny nr sa scaae ude eaatoradeneguanvarnaauenidan: newogrp(1) 
group, and effective GroUp/ o.oo... eccecsceecessreeesessneeseeeees getuid(2) 
group, and parent process IDS. ou... ecccessseceserseeees getpid(2) 
QTOUD MG secocciccensercoelc copes via nutes ee toon group(5) 
group file entry. /QetgrMaM, ............. cece ceeestcesseeceteseeeees getgrent(3C) 
GOURD Group Mee ssses aivcverncessesasipastecces sausatarastiatectueae evens group(5) 
POU IO ss coeciticuFsctie det ccceaaidasensaubeecesnesdtaoaceat tee ttascionee igen setpgrp(2) 
QHOUG IOS icidensictnncarenen en iertierdcaatesdvauniecoiteelenacmaanals setuid(2) 
Group IDS ANd NAMES. ........ ec estccessteesesssceeesesseeeeeseaaes id(1) 
Group IDs. /effective USEF, 00.0.0... ccc csssccesseecetesseeeeesessseees getuid(2) 
GIOUD OF BGs oivascieiiseteschccaesecetiad sec vccedvaavesaeatsoan eaanaveerns chown(2) 
GrOUP Of PrOCESSES. /SONG ooo... cect tssceceesestceeesetteness kill(2) 
groups of programs. /MaiINtaIN, ............. cc cccssstseeeeeseenes make(1) 
QIPCk: PASSWOFd/GrOUP FIC ee ecetetteeeestteeeeeseneees pwek(1M) 
gsignal: software Signals. .............c.ccccssssesessscsseseteceeseseenes ssignal(3C) 
QUESS ING WOID: ciscticd arsinisisvinietrinncas aia sae hangman(6) 
QUESSING ‘GANG sass sieyeiaje ysasdsasesdstevtinccuuteueswssuccncstpouaiseriess moo(6) 
handle special fUNCTIONS Of .......... ec eeessteceeeeeeestereeeereseene 300(1) 
handle special fUNCtIONS Of .............ccccssstscceesessststeeeseesenes 450(1) 
handle special functions Of HP ou... ee eeescsssseteseeeeeeees hp(1) . 
hangman: guess the WOOP. .............. cc ccesssrecesssseeeeeeserseeeeees hangman(6) 
NANQUDS ANG QUIES: cidis seissseceevetentereiavsssevedexine dented adenones nohup(1) 
head: give first few liN€S Of Ao... ee eeeeeeeeeeeetteeeeeeees head(1) 
TNO foo csia spate ec catesrncnce Maimanaveseauenmaceets Sits nakeaaseneecataeee lst help(1) 
NOID SASK TOF EID sci siissscciestvedsnsonetcndevstvacwadaosaseaousyener catvavece help(1) 
holidays and prime time fOM 00... ecetseeseteeesetseesseceseaeee holidays(5) 
host file. /take @ COPE IMAGE... ceeceseecceeesssstneeneeeeeeee icpdmp(1m) 
POSIS -cecswtcxrpuciziontetvsateanctsaiets en yeaa a sheeataareannied node(1M) 
HP 2640 and 2621-—seriesS/ Np: ......... cc cccccsceeeeesesetseteees hp(1) 
hp: handle special fUNCtIONS .................cccceccesseecsseseseseeterees hp(1) 
NUNT=INE =WUMPUS . isseicesscezeicne droite aeescesened aaitivwatete aceon ndoceors wump(6) 
Wyperbolic FUNCTIONS. .......... cc ceesscccssssreceessercesessseneetsceeeetens sinh(3M) 
hyphen: find hyphenated Words. .............:::ccecessssssrereeeeeeeees hyphen(1) 
hyphenated WOrdS. ............ccsccccsssccessseccessecesseescessseteessnecesssaes hyphen(1) 
hypot: Euclidean distance. ..............ccsccssescscsssseecceeeeseeeeees hypot(3M) 
MBI ccioeaes cocecshterces detgastuaedence sci gescceucseniensente esa orm ntosei ee nactius rje(8) 
ICP and transfer to a host fil€. ..... eee eecceessnteceeeeeees icpdmp(1m) 
icp: Intelligent Communications ............. cc cesses sesreeeeees icp(4) 
ICP; print VPM traces. ............scesssssscsesesesceeeeseeeesseneeesasens vpmstart(1C) 
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ICP and transfer to a host file. 
setpgrp: set process group 
syscall: numeric 

and names. 

what: 

Id: print user and group 
group, and effective group 
group, and parent process 
setgid: set user and group 
copytape: make an 

core: format of core 

a host file. icpdmp: take a core 
swap: 

crash: examine system 
pnch: file format for card 
nohup: run a command 
‘strings from C programs to 
pt: 

pd: 

Processor 

dump: 

restore. restor: 

dump: 

Agetstr, tgoto, tputs, terminal 
pix: permuted 

control information for 
initialization. 

init: process control 

rc: system 

process. popen, pclose: 
for init. 

clri: clear 

inode: format of an 


fscanf, sscanf: formatted 
push character back into 
fread, fwrite: buffered binary 
stdio: standard buffered 
fileno: stream status 

uustat: uucp status 

install: 


abs: 

/tol3: convert between 3-byte 
3—byte integers and long 
Processor. icp: 

Processor imsp: 

bcopy: 

system consistency check and 
rjestat: RJE status report and 
diction explain: 

err: error—logging 

plot: graphics 

pp: parallel port 

st: synchronous terminal 

tty: general terminal 

plot: graphics 

spline: 

rsh: restricted shell (command 
sno: SNOBOL 

pipe: create an 

sleep: suspend execution for 
suspend execution for an 
commands and application/ 
subroutines and libraries. 
miscellany. 

formats. 


files. 

‘calls and error numbers. 
maintenance procedures. 
application programs. intro: 
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icpdmp: take a core image Of the ..............ccsssseecesseererereees icpodmp(1m) 
UD ssicescaaiesectcsics bee ceasauabatuscavieettnessouser tesa uuausicetesemn amaneueetenes setpgrp(2) 
Id Of SYSTSNY CANS. Socccsd assess sot sues vari osresseneteeSiansuxtcoancduucaasecenat syscall(2) 
id: print user and group IDS 0... cece teteeecneeeeenseeees id(1) 
identify: SCCS TOS sa. saisiacacccosesvewwved vox cuovstscuasaietis esaveareoneneese what(1) 
IDS ANG NAMES: issn eect nsnnemiwonimeiaae id(1) 
IDs. /effective USEF, Fal ..............cccsseecccecsetstcceeeeseeesesteeseceoes getuid(2) 
IDs. /get PrOCESS, PFOCESS 0.0... ceseeseeeerecteceseeseceeeeeneees getpid(2) 
IDS: SOU, Sekicsissisbeiccctss na eevevesnncte sees torntie aes oevsineias setuid(2) 
IMAGE COPY Of a TAD y: sccsctiscncssaseecvnacascasnscastienseemesevedaaaonieneos copytape(1m) 
WAGE TO cuscrdcescecreies athe ta uation aes iaeenor core(5) 
image of the ICP and transfer to ............ ccs ccssesesssseenesees icodmp(1m) 
Image Of the SWAP AFE@ 0... cee eects tereeessescesseseneseesens swap(4) 
WNAQCS 5 asian siecaicateauey a acer snaeaticesrawautuntanieuaaipam auarecmueees crash(1M) 
WME QOS 5 ses setitonasdevesiceacessiaacetscGuensecaaes scene ons euseaeactnescauiasasanes pnch(5) 
immune to hangupS and QuitS. ......... ee cseeessetseeeeeseees nohup(1) 
implement Shared StringS. ...............cseecsececeecseesseseeasaeesseens xstr(1) 
IMSC cartridge Controller. .............:cccesssscesccesesssscsesesneneseces pt(4) 
IMSC disk Controller, ..............ccccssscescessscecsesseeceesssecsecensnsesens pd(4) 
imsp: Intelligent Mass Storage ................c:cssssseessescesseeteees imsp(4) 
incremental dump tape format. .............cs:cccccccccessssssssseaeees dump(5) 
Incremental fil€ SYSTEM ..............cccscessssssssescccecsseeeeeeensensesecs restor(1M) 
incremental file SysteEM GUMP. ..............cceecccetsssreeeeseeteees dump(1M) 
independent operation routineS. ..............c.cccccessssseeeeeeesees termlib(3C) 
WNGAON: cseacceseassvecadeeinsaccriacncenaedacateenscuhisousaisieas siesta sete ptx(1) 
WIE, AA = fo ees vast citousi rasan dunes uadansiceuavsunetixnrsd eee inittab(5) 
Init: PFOCESS CONIIOl as scccccsssccens srecsacsieesteasaansncdeccdisgaciesenveaczeeas init(8) 
WUT ZAUON <. ssacisiasis iicstisbecn ace voc eecternesce sei Qendienanentas cia mae whabes init(8) 
initialization Shell SCript, ..............cccssccccsssssccsssssrsesssseceeeseseeees re(8) 
Initiate VO tO/FrOM a. ........cccccsssessscssscssssscsccssssrnseeecesssesnsecceenes popen(3S) 
Inittab: Control information ..............ccccccssesssererecerecceees Aiuadeatieae inittab(5) 
BOOS visa cs vain hse is Sonera Cac Sen ceed cto ce eeeauaecmen eee cscs clri(1M) 
WOODS ag co ocidcrsesncuesiensticausa ves itaven cavaccvussausisee set neadatete onnnanaie inode(5) 
inode: format Of AN INOdE. .............csssecccesssececcecsesstsceeeeesenes inode(5) 
input CONVErSION. SCANS, .............cccccessccceserssssescestessseseseessees scanf(3S) 
Input Stream. UNGEIC: ............ccccsssseccsssrteccessrssessseesceesssrescees ungetc(3S) 
VU OUTIL, 5 ents cas ccrvesusedadebencanectvezmberans taeee neta aakesanane fread(3S) 
INDUt/OUtPUt PACKAGE. .............cssccsescsssscscsteesrsesssssssssessececseens stdio(3S) 
inquiries. feof, Clearers, .............ccscccsssscccssrscessscscesssessssetenees ferror(3S) 
INQUITY ANd JOD CONTLOI. .............ccccsscssccccsessrrsescecesseeesosesesaees uustat(1C) 
Install COMMAMNAS. ...........cccescceseccccessssssstseessccceessssssrseseeseees install(1M) 
install: install COMMANAS. ...............scccccccesssnscceccessseneesenenseeers install(1M) 
integer absolute ValUC. ................csscessssceserscesssecessecceseeessees abs(3C) 
integers and long integers. ..............cssccccsssscessssesssseceseeeeees I3tol(3C) 
integers. /Convert DEtWEEN ............ccsccsscccesssesssesesseesseeesseees I3tol(3C) 
Intelligent COMMUNICATIONS ..............cccscccessessscessssesssssesensenes icp(4) 
Intelligent Mass Storage ..............cccscccssssesssssssseessseessesesseess imsp(4) 
Interactive DIOCK COPY. ...........cssccccsssssssrceseeesesssetessssesssecesnes bcopy(1M) 
interactive repair. /filO ............ccccscsssssssrtcceccssceessssserseseeecsens fsck(1M) 
interactive StatUS CONSOIE. ..............csccccssscsscesssesesseceseecesseens rjestat(1C) 
Interactive theSAUFUS FOF ..............csccccsssssccersrsscessstscesssseesenes diction(1) 
WGI ACO seticesipetiasvecanre ic paie obec cx tutesesouaseriesiaee ease eectetons err(4) 
MNTIT ACG go cccaiewescvsscucvag vaceiscecaeleencaasaieeosaaininaasoxoseaocmecnnees plot(5) 
WG FACE 3s seses cs testarel aun lestinvacesapteiinrsseneioveaeteneiivaed eae nee pp(4) 
WING ACO ios ceesces ncrcenscieatsicuescsieiscecutawain desea sae iaeseG aie st(4) 
MARC ITACO * \osecsicisscdapisatsscoducsanscaasenett ecedcaws sateen ereuasennaaniiete tty(4) 
Interface SUDFOUTINGS. ...............ccccsssrcscsscsssresceeseessecesecensnsssens plot(3X) 
interpolate SMOON CUIVE. .........ccccccsecccsscessccsstseesseceteecsssenss spline(1G) 
MMQIOIOICL) «occ cen ces stro viarverstesaddercetesctuises tes sitcitensdesttoseraitec: rsh(1) 
WO DIO TO Ns stay ede cccia tr cnnes sencnes ais seeceeuauiv ee een sno(1) 
INterprocess CHANNEL. ..............cccccccsssscsssecseesceccccesssssssereesseees pipe(2) 
AMO NV seat oh Su aceas seteaine abc aganuseas seliealsd Seven eadesaneraattepiesdense Rs sleep(3C) 
interval: SIGCD: sis aes cacscicencein acasasecassaccdsguas sacs eoreanearsantsn sleep(1) 
intro: introduction to ....... de iaiteaineacalsbea hnnilaté CasaberBentedstaniaaseaeuastes intro(1) 
INTO! INTFOGUCHON 10 siisvsiencevesescanetecdieeteesseastsoverdon ia ieee intro(3) 
INTO: INTFOMUCTION 10 .........cccccccccssccsscescecccesecssvevessececssesessneees intro(7) 
Intro: INtrOdUCTION tO FIO oo... ceesscessscceesstececeeseterenees intro(5) 
Intro: INtrOdUCTION TO GAMES. .............ccssstecsesesstsececssettseeseens intro(6) 
intro: introdUCtION tO SPECIAL ..............cccccccccecssssessrsccsscecessenes intro(4) 
INtrO: INtFOMUCTION tO SYSTEM ...........cccecccccssssccccessteseesteseeeseees intro(2) 
Intro: INtrOdUCTION tO SYSTOM ............c cc ccecesccessstseecestsseesseeees intro(8) 
introduction to commands and ..............cccccccesssrcecesrrreceseees intro(1) 
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intro: 

intro: 

intro: 

intro: 

and libraries. intro: 
maintenance’ intro: 

and error numbers. intro: 
ncheck: generate names from 
liomem: local device 

popen, pclose: initiate 


abort: generate an 


/islower, isdigit, isxdigit, 
isdigit, isxdigit, isalnum,/ 
isprint, isgraph, iscntrl, 
terminal. ttyname, 

is: 

/ispunct, isprint, isgraph, 
isalpha, isupper, islower, 
/isspace, ispunct, isprint, 
isalnum,/ isalpha, isupper, 
/isalnum, isspace, ispunct, 
lisxdigit, isalinum, isspace, 
lisdigit, isxdigit, isalnum, 
system: 

isxdigit, isalnum,/ isalpha, 
/isupper, islower, isdigit, 
news: print news 
functions. 

functions. jO, 

bj: the game of black 
functions. 0, j1, 

operator. 

files. openup: 

makekey: generate encryption 
openup: keep open 
process or a group of/ 


mem, 

3-byte integers and long/ 
base-64 ASCII. a64l, 

copy file systems with 

with label checking. volcopy, 
efl: Extended Fortran 
scanning and processing 
arbitrary—precision arithmetic 


standard command programming 


Plexus Sys3 UNIX 


bbanner: print 


mantissa and exponent. frexp, 
getopt: get option 

simple lexical tasks. 

generate programs for simple 
to subroutines and 

relation for an object 

ar: archive and 

ugrow: change system stack 
ulimit: get and set user 

line: read one 

nl: 

out selected fields of each 

Ip: 

Ipd: 

lpr: 


Isearch: 

col: filter reverse 

files. comm: select or reject 
uniq: report repeated 

head: give first few 

of several files or subsequent 
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Introduction to file formats. .........ccccccccscccsscssecssssssscescesseeseee intro(5) 
INtrOGUCTION TO GAMES. ..............cccccssscssssosscesssecsstscesseccesssecees intro(6) 
introduction to miscellany. ............ccccccccsssccssscscscsescestsessceseees intro(7) 
introduction to special filOS. 0... cccessscssscsscecscesceeseesees intro(4) 
INtrOdUCTION tO SUDFOUTINES 0.0... ceccccccesccssscesssccssscecssosses intro(3) 
INTFOGUCTION TO SYSTEM ...........ccccsccsesscssssessscreccsesesssccsesessoeees intro(8) 
introduction to system CallS .............ccccccccesccecccesssesscsssecssees intro(2) 
PSTD ONS » -iascdcisesatnwatictesasteusc’ vesusassasitetuccvees ike hoaciceides ees ncheck(1M) 
MO OIMONY® Scsech Ace onates vossezscansa nasiveditsstesecabigin Reodedviandioins mem(4) 
WO to/FroM @ PFOCESS. ...........ccscsscsscsecsccsscesesssesscessccuseescreseees popen(3S) 
loctl: CONtPO! MEVICE. 0.0.0... sessscssscssscscsscssescesscesseccesserersscees iocti(2) 
NOT TAU seca scdun lca sacar inccacadove teateeet iunassa died Totacicaisheoudidiccak abort(3C) 
is: SBC disk controller. ..........c..cccccccscssssssccsssscsscssesscccssescecs is(4) 
isalnum, isspace, ISPUNCT,/ .............ccccccccceccccesscetecessscsesesseees ctype(3C) 
isalpha, isupper, islower, ........ iediehavetap tasieatisletieses eenantinies ctype(3C) 
isascii: character/ /SPUNCT, ..........ccecsccsesssecssecsscsscssscesecessses ctype(3C) 
isatty: find Mame Of @ ou... cesesscssseccsscsscsssrcestsccsecssersecrsseess ttyname(3C) 
iSBC disk controller. ...............00. Wale ecu bacuhat dusattetoniteca sash mites is(4) 
iscntrl, iSASCII: CHAPACTEL/ ............:secscccssesscepscesscsscessssccceseecees ctype(3C) 
isdigit, isxdigit, iSAINUM,/ ............ccccccccsscssscsssssssecsssccssecesoseees ctype(3C) 
isgraph, iscntrl, iSASCH/ 0.0... ccc cssssssscsssesscesseccscessccssccscecess ctype(3C) 
islower, iSdigit, ISXigit, ..............ssscssssscscssscrssesscsessesscssscsecses ctype(3C) 
isprint, isgraph, ISCIMHT,/ ...........cscccccccscssscssccseccecsecsssscsesecseeees ctype(3C) 
ispunct, isprint, isgraph,/ ..........ccccscccssccscssesccrsctsssscsecsesssssees ctype(3C) 
ISSPACE, ISPUNCT, ISPFIN/ ............sesecessscsssssscsscessccscecsesceseesers ctype(3C) 
issue a shell COMMANGA. ............c.cccccccscssssescessescssessscsecsessees system(3S) 
isupper, islower, iSdigit, ..............cscscscscscssssssscescssessssesesees ctype(3C) 
isxdigit, isalnum, isspace,/ ................ (eee tasty Canes canabewucteraee ctype(3C) 
NOUNS 5 Wa. S2.csausvtincaaciaesaacertaeiateartesaatdcceteralin elidecurtantincial aes news(1) 
JO. j1, In, yO, y1, yn: bessel os cscscescccsssstscsscsssesees bessel(3M) 
j1, JM, yO, y1, yn: DeSSel ol csecscceccrccssceecssessecsseree, bessel(3M) 
NOK i, Shocs wana nuuisiuatphaceasoens aie Rites csc Leases tun hosts hacen aac: bj(6) 
in, yO, y1, yn: bessel .................. facihneueeter ci clusscmey unter estx: bessel(3M) 
join: relational database ............ccssccsecesecccccssssssssessscssesess join(1) 
keep open key directories and ........ccccsccscccscsccsscesecccseesene openup(1) 
RY ecb ereta testa becic daca lah atv eie oe ia ces tecvatin es eestceecusoieaca aeetaa tes makekey(8) 
key directories and files. ..,........cscccsscccsccsscecesccsssessssessercoseees openup(1) 
Kill: S@Nd @ Signal to 2 uu... cscscsscssssscsscsscescsssessscsoscersees kill(2) 
kill: terminate a process. .......... seasee ub saieedeieaseeesateagaetotiauesseias kill(1) 
KMEM: COPE MEMOTY. ........ssccccssscsssssscscssccrscssescssssssssseseorecs mem(4) 
IStol, Itol3: Convert DEtWEEN ..........cccssssccessccsssscsscceceeseecees I3tol(3C) 
l64a: convert between long and ......... ee er oe a64I(3C) 
label checking. /labelit: .....,......ccccscscsssssssssesscssees biapinsapeaeuteaes volcopy(1M) 
labelit: Copy file SYStOMS .............sscccssessssscescsscscsscssecsecscece. voicopy(1M) 
LANQUAGE. ............cscessccescsssscecsrenseceses aaeadestnaa acd adaed atid, efi(1) 
language. awk: pattern ......... aadiesebicewiastdeccack svenesseasuakanteesces awk(1) 
FANQUAGO DG? ice dos scacs tence ox canvsesuvorausdesgecesarestuctasevwiosoveouiicx be(1) 
language. Sh: shell, the ............ccccccsscsssscsssssssssscsecssssesses. sh(1) 
large DANNEr ON PFINtEL. ......,..ccccccccssscrsssccscssssosscsecssssessees bbanner(1) 
Id: link editor. .............cccc savesstubvetuansieeccatss cette evacte ceases Id(1) 
Idexp, modf: split into ............ esse. busts inulebe lage devenws nawiees frexp(3C) 
letter from argv. ............ ala letecsvessdex fui saicctbabeedid eapsiseencueuce getopt(3C) 
lex: generate programs for .........ccccccssccecssesssssccssssoseseesee. lex(1) 
lexical taSkS. 1X: os eecssssessssssccstsesssscscescsssessscsscscsesers lex(1) 
libraries. /INtrOdUCTION ...........ccscccsssscssssesseccscsssssssssesssescsesees intro(3) 
library. /find ordering .............cccccscsscsssscssssssscsssesssscsssesceesee. lorder(1) 
library maintainer. ..............ccscssccsscsecsercesssscssessssssessscsessecsees ar(1) 
BUI secreted asc ctetun tsesomncacspsien nasties suepdevesthe eeccietel i ugrow(2) 
MPTNTS 5S ance gear tnncapsivers adecddee ort awstacdusurae ies sateibucdloatoetercis ulimit(2) 
WING s spisnccuensteesivacaiadeneeeceasenaeah maeinsthcietscdctasue ste tigasteies sarge td ead! line(1) 
line Numbering filter. 00... ssesesscesssssscesscscssscesssecsessceecee, ni(1) 
line of a file. CUt: CUT o.... cc lccccsccrecsccsssctssstesesceseecees cut(1) 
NING DOING i rssoxcarate st deane cissevess neepisteeuuca cient Mcehn. tse utes Ip(4) 
line printer MaCMON. ...........cccccsecsscsscscssstscsscssssscecsscecesecceee, Ipd(1c) 
line printer SPOOIEL, .............ccccssccsccssscsscssccsssssecsssessseeeees sicoss Ipr(1) 
line: read ONE MINE. 00... eesseccscesececeeeseseres rT ee eee line(1) 
linear search and update. ..,........ccceccssseccccsccssscscccsessseees lsearch(3C) 
WOSISCOS®, Sissi ssasti tina cistns nievenlesean eri acageveute ie ee newataes col(1) 
lines COMMON to tWO SOMted ........cccccccececsseesctsceteceseesesses comm(1) 
NGS Ah NU es cs rten tec cise acess cntaues erausnoovainesgcuevisasuadecionte Gor uniq(1) 
lINGS Of @ STEAM. ..............ccccsccesessnsscecsssesscesscarcessccessessesenes head(1) 
lines of one file. /Same liN€S ............ccescecccsscescccesseceessees paste(1) 
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subsequent/ paste: merge same 
link, unlink: exercise 

, Id: 

a.out: assembler and 


cp, In, mv: copy, 
link: 
and unlink system calls. 


niist: get entries from name 
nm: print name 

Is: 

bis: 

by fsck. checklist: 

cref: make cross-reference 
xargs: construct argument 
files. cp, 

vpmstart, vpmsnap, vpmtrace: 
liomem: 

tzset: convert date/ ctime, 
end, etext, edata: last 

lock: 


regions for reading or writing. 
gamma: 

newgrp: 

logarithm, power, Ssquare/ exp, 
Nog, pow, sqrt: exponential, 
errpt: process a report of 
dconfig: configure 

getiogin: get 

logname: get 

cuserid: character 

logname: 

passwd: change 


setting up an environment at 


a64l, |64a: convert between 
between 3-byte integers and 
setimp, 

for an object library. 

nice: run a command at 


directories. 

update. 

pointer. 

integers and long/ (Stol, 


vpm: The Virtual Protocol 
for the virtual protocol 
documents. mm: the MM 
graphs. mv: a 

mé4: 

mmchek: check usage of mm 
manuscripts. ms: 

in this manual. man: 
formatted with the MM 

tp: 

send mail to users or read 
users or read mail. 

mail, rmail: send 

malloc, free, realloc, calloc: 
regenerate groups of/ make: 
ar: archive and library 

intro: introduction to system 
SCCS file. delta: 

mkdir: 
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lines Of S@VEral FICS OF ...........ceesceseesteeseersctereessseseetseeanees paste(1) 
link and UnliNk SysteM CallS. ........c cece ceteeeneeeteeesteeeens link(1M) 
NANG CIO sored csiscadtensedcaaisdiesicaeta dese hecantatetsteatd iniseausrveonses tincee Id(1) 
link: SOK OUTDUR..<cisnicsscsecverescscscissaeashans daze enteds uendihwetantbesacsss a.out(5) 
Hirai WEAK 10: FUG: -socadeccedesdesssecceetastasayeanwv eats catanesetaaanestagenes link(2) 
HK OF MOVE: THOS: sus dies sissasceascercaviineccd ant eaaqarinvederreisartonesneris cp(1) 
EU $0: et WO. oes eveircreaedidesaredtiniatie teens wench estar amends link(2) 
link, UNIINK: ExerciSe TINK ......... cece eretseeeeseeeeeseeeanees link(1M) 
lint: a C program CHECKED. 00... ccs eetecteteeneeereteees lint(1) 
liomem: local device VO MOMOLY ........... cc esscseereenseeeeetees mem(4) 
BS te cSaoceocausa rs aces soceateseiapsie se saa cena eee steal ntedeian ome antegiatane: nlist(3C) 
SE caine cca ocualecben eassoeecensss tre rane sina ea Nei ener excel nm(1) 
list contents Of GIrECtOTIES. ......... cece eetscesesettteeecceeneseeneeenees Is(1) 
list contents Of GITECtOLY. 0.00... cececccsteessteteessscetnescneeeeeeees bis(1) 
list of file systeMS PrOCESSEM .......... cece ecsseeseeeesneeetaes checklist(5) 
STING cecsisicdiecachasresprstioearran cas tincteinagiediuentumren tiene cref(1) 
list(S) and Execute COMMANGA. ou... cece cseeteteeereesteetees xargs(1) 
In, MV: COPY, TINK OF MOVE 0.0... ccscccstseteceteeteeteeeeceeenees cp(1) 
load the ICP; print VPM/ ....... ccscsccsseeescetsstseesteeeecnees vpmstart(1C) 
local device WO MOMOLSY ......... ccc ccscetecsscsttecstsseteeeenerens mem(4) 
localtime, GMTIME, ASCHIME, .......... cs cece ttecsecneeeteeteenees ctime(3C) 
loCATIONS IM PFOGFAIN. ......cscccsseccssssscsecescssesessssereserstsenecees end(3C) 
lOCK @ PFOCESS IN MEMOTSY ....... cc cceceseeesteertestetteseeeentaeseees lock(2) 
lock: lOCK @ PFOCESS IN MEMOTSY ........cccecceserteeserecesttseseraees lock(2) 
locking: provide Exclusive IC 0.0.0... cecceeeeteeeteteeeeeesens lockf(2) 
log GAMMA FUNCTION. 0.0... ceeescteeeeeeetseseetestacneeteereseeees gamma(3M) 
log IM tO A MEW GLOUP. ........ceceesersescseeeeeeseeseesenteesseeseenenees newgrp(1) 
log, POW, SQIt: ExPONENtial, .......... cesses eteteteereees exp(3M) 
logarithm, POWEr, SQUALE FOOL 0... cece eeettseteeetaetesens exp(3M) 
LOGQOd OFTOLS. ........cececssessscssnsssersessstsssresssensneresnnsosesnvonacenee errpt(1M) 
fogical GISKS. ......:.-coseccosssossccisacsssssniesnsessserssrsssnetereacesscerenss dconfig(8) 
TO GIP: MAING s. siden seavisedcccurasosneavitectvereineneene es eames getlogin(3C) 
LOGIT AUN C  sa ci sea tes ee csccnse voducdnicscssvesenntuaeneates edeteusnvansdunen sevens logname(1) 
login Name Of the USEF. ......... cc eeeeeeteteesereseeeteteetereenecees cuserid(3S) 
login name of USEF. ............ceees bes den amdersactsn dels COs Seilaamaests logname(3X) 
lOGIN PASSWOF. 00... ceecesesrestecsteneetertereretsceaeeeeesansersnstarenes passwd(1) 
HOGI: SIQM ON. ou... ecssessscssscceneessrssesssenestseretesssesesssneeseoessees login(1) 
login time. Profile: oo... eee etesteeteereteteeeneeeteeeeessrenes profile(5) 
logname: get login MAME. .......... ccs eteneeretteetseneetees logname(1) 
logname: login name Of USEF. .......... cscs eteetetteeteseees logname(3X) 
long and base-64 ASCU. 0... cesses tetseeneceeseraeeeneeees a641(3C) 
long integers. MOIS: CONVEST «0.0... ceeteteeeeteeteteetees I3tol(3C) 
lONG|MP: NON—lOCAl GOTO. .........secseeereeeseeeerertetseeneenterteesenes setimp(3C) 
lorder: find ordering relation ...........eceeesstneeeeteeeectaees lorder(1) 
lOW PrlOrity. 0... cccccssssesessasseserseetesesssssetenrstseeneeneaseesesecoees nice(1) 
ID: FE PKINter. 0... ce eeesceeeteseeteeetserenessesessetssseneeeeeseees Ip(4) 
Ind: line printer CaeMON. ......... cesses etsessesetserseereeeees Ipd(1c) 
lpr: line printer SPOOIES. ..........cseeeeescereteetsetsseseteseneeteneees ipr(1) 
is? liSt CONTEINIS OF aiisicacaseritvinasintintiensnpontnnteieamatiaceds is(1) 
Isearch: linear SCALCH AN... ce esctesstetsescereseteeeseeeeeees lsearch(3C) 
Iseek: MOVE read/Write FIO... cess eceteentteeeeeseeeeeees iseek(2) 
Itol3: convert between S—DytC ......... cess ceeeeeeeeerereteeeees I3tol(3C) 
M4: MACLO PFOCESSOF. .........ccssccsesrceresreseeerserseestsesseeteeceeeens m4(1) 
MacnitiO:..asciccucciicctecatarciorn tn Gee eee vpm(4) 
MACHINE. VPMC: COMPIEL ........... cc cserecerectceeerenrerereeeees vpmce(1C) 
macro package for formatting ..........ccccseereeceenseneneees mm(7) 
macro package for making VIEW ......... ce eerestesetsenees mv(7) 
MMACTO PFOCRSSOS. 2.0.0... se cecsesscrseseereseereesenecseesseeeerensensesrensees m4(1) 
Macros ANd EQN AeliMItELS. .............ceccereseresserteeeseerereees mmchek(1) 
MACPOS for FOFMALING ............ cc eccessrecoessenerseeseneeetstesescnseees ms(7) 
macros for formatting ENtri€S ............ cece esesteeesteeeeetenees man(7) 
macros. /print OUt COCUMENTS ........... ese ceretseetecteeteoneeens mm(1) 
Magnetic tape format. ..........sccccesernrteerstterecesstseeneeenes tp(5) 
mail): Mall. TAN? scccitdimeeiimians nn iaiiwinonacimmdes mail(1) 
mail, rmail: SONG Mail TO 2.0... eee esstscestseeesesteeseeesenseesenes mail(1) 
mail to users OF read MAIL. ou... eee teeteteceesteeeteesenneees mail(1) 
main memory allocator. 0.0.0.0... ccc ceessseesceeeseeeresenseeeeesenes malloc(3C) 
Maintain, Ubdate, ANG o.oo... ce ecessetteeceeeeecetteeeeetteseeeees make(1) 
FURGUNALAUNOE scree cc tectisn aac edpanwes thea ontosvciant ite Seaaabsdaaeenentancase ar(1) 
MaAINtENANCE PFOCEAUIFES. ..........cccesccessseereseesesseesssereneesens intro(8) 
make a delta (CHANGE) tO AN ou... eceeceseeteeteeeeteeeseeeees delta(1) 
MAKE a CIFECTOLY. ..........:ccccccsscsscessesseseessesesssssessesesesusetersesees mkdir(1) 
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or ordinary file. mknod: 
mktemp: 

cref: 

regenerate groups of/ 
banner: 

key. 

main memory allocator. 
entries in this manual. 
manual. 


tp: 
fwtmp, wimpfix: 

tape: tape 

frexp, Idexp, modf: split into 
man: print entries in this 

for formatting entries in this 
ms: macros for formatting 

ascii: 

files. diffmk: 

umask: set file-creation mode 
set and get file creation 

imsp: Intelligent 

create an error message file by 
table. master: 

information table. 

regular expression compile and 
eqn, neqn, checkeq: format 
memory 

*mbiomem, mbmem:* Muitibus 
*mbiomem, mbmem:* 
*mbiomem, 

as.68000: 


"mem, kmem:* core 
*mem, kmem:* 

*mem, 

lock: lock a process in 
liomem: local device /O 
mem, kmem: core 

free, realloc, calloc: main 
a process to access physical 
sort: sort and/or 

filles. acctmerg: 

files or subsequent paste: 


source. mkstr: create an error 
mesg: permit or deny 
syS_Nerr, errno: system error 
rm: Cipher 

and commands. 


special or ordinary file. 

file by massaging the C source. 
name. 

formatting documents. mm: the 
mmechek: check usage of 
documents formatted with the 
formatted with the MM macros. 
formatting documents. 

macros and eqn delimiters. 
view graphs, and slides. 

table. 

setmnt: establish 

chmod: change 

umask: set file-creation 
chmod: change 

tset: set terminal 

getty: set the 

bs: a compiler/interpreter for 
exponent. frexp, idexp, 
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make a directory, Or a SPeCial .............ccscccssssssessscsescseesseeee mknod(2) 
Make a UNIQUE fil€ MAME. .............cescssscsecscstscsesssessecessessees mktemp(3C) 
make cross—reference listing. .............ccccscsscsscsssssscssesesees cref(1) 
make: maintain, update, and ...............ccsccecssscssssssssccssesecees make(1) 
ITIAKG POSIOMS 55 sssvecssceasccesanascvudesensssncsssatsvvncavinesiacsssdiavcaciociee banner(1) 
makekey: generate encryption ...............cccccscssscsssessscosteees makekey(8) 
malloc, free, realloc, CallOC: ...............ccsscssscsscesscsesceesssessees mallioc(3C) 
man: macros for formatting ..............cccccssssscccsssssscsssssssceees man(7) 
ManN: Print ENtrieS IN THIS oo ce cceeeteecesseseessesseressnsees man(1) 
Manipulate tape ArChive. .............ccccsesccscccessesceecsscssescstsceenes tp(1) 
Manipulate WIMP reCOrdS. ..............cccscsscccssccccessessssoseseeeeees fwtmp(1M) 
FTIATUP ULATION: a. ica sccisectesssecavesncsivsgédesetecdonsscavnesuacannnasccdedssecces tape(1) 
MaNtisSa ANd EXPONENT. ou... ccesscsscssssesssceersessessssseseees frexp(3C) 
NAMEN sss Gesotd. scans urcetateresiecereieschasawtosausatldeweto eavacseateds man(1) 
MANUAl. MAN: MACOS ............:ccsscccesssssecossecesseceescessseeees man(7) 
TAMUSCHIDIS sais scsccovveaai ancescacecavessceiesuatisevaces sade wleesa Ganecee: ms(7) 
map of ASCII character Set. ...............ccccccssscssesscssesesssssceseees ascii(7) 
mark differences DEtWeeMN ................ccscssccssscsseccersssecseoeees diffmk(1) 
PINS scree sia cascades aad sea talect tae negeetises cans oeleareaiseans econ umask(1) 
IUIASIC 5. CTRASI 5 os cas nas rs nas hwactesaanente ns ainaus Bieibaatevenndneteauareds umask(2) 
Mass Storage Processor .............:cccssscsssesssesscssossscssssecseeees imsp(4) 
massaging the C source. MKSIP: ..............c.cccccssssessessseseeees mkstr(1) 
master device information ..0............cecccsssessssssssssssssceeseseeses master(5) 
Master: Master GOVICE ..............ccsssssseccoesssssccesssssesscessseeseesees master(5) 
Match rOUtiNES. FEGEXP? ...............sscescecvessesescsosssseecccesestecseees regexp(7) 
mathematical text for Moff OF/ os cesssessseecessessesssosessones eqn(1) 
*mbiomem, mobmem:* MulltiDUS .................. ccccccsesscccsseseneees mem(4) 
PSN ONY. os ciecsrtce Sr eacehera gata aeistaceatresmeshodseveataccinzs coins esunateweent mem(4) 
MUItIDUS MOMOTY 000.000... ccccescessecsecsetssssessoessevsesesssssesseeees mem(4) 
mbmem:* MultibuS MEMOTPY ...............:cccscccssssssssessesenssserees mem(4) 
MC68000 assembler. ...............:ccccccsscsssssscssesssscsscessossseseseees as.68000(1) 
"MEM, KMEM:* COPE MEMOLY ...........ccscccsseccsssessssccsteesesseees mem(4) 
MEM, KMEM: COFE MEMOLY. ..........ccccssscssecssssssresscscssseesossees mem(4) 
INOMONY sa sossorsiestsct devas, covectwve Oi tanenconss Gab besiesealosesadsedvocossiee Mees mem(4) 
COMO IMGINOLY: sass vscsscies cece iicasarnisceataatcesiisncacsnunsaieosseotaccdcnaincvs mem(4) 
KIMOM:" COPE MEMOLY ..........cccccsssscsssesssssssrssstssrsssssssesesesees mem(4) 
PURUTIONY sep rsedtesulecchciasssactsdis ss acsacsiesvcuateasevapccan seeing eee alt vousons lock(2) 
TINQITIONY sien cs idssaiaicck sor st ces gneessc toraaatuntabsastiewece spessedvocaneesniuecasies mem(4) 
TVIOIMONY sss csssorecsecesesedior cases sateen acyuacseeeadecens vasa scesomniastans eases mem(4) 
memory allocator. MallOC, .............c0ccccccsssssccsscssscssessstsesseses malloc(3C) 
MOEMOTY Phy: AllOW 00.0.0... scssesssssssccecccesesssserrenecessseseeeens phys(2) 
MONGG TOS . csssrcnisieernimsete neice ayant teenies sort(1) 
merge or add total ACCOUNTING ...............c:scccssesccsssstersseeseres acctmerg(1M) 
merge same lines of S@VEral 0.0... ses cssstesestseesteeeseees paste(1) 
mesg: permit or deny MESSAGES. ou... ccscsesenseceseenes mesg(1) 
message file by massaging the C oo... eceseeeseeeseees mkstr(1) 
IIOCSSAQOS 5 «as iicsscasseisoensas cate iss sdestensesteeatteatitunnce Wl ataarieyecens mesg(1) 
MESSAGES. /SYS_EFTMISt, 0... ccesceccseescesscsscsesestsesteseeees perror(3C) 
Microstreamer tape CIiVe. .............ccccsscserserstessrsesssseseeessreess rm(4) 
mk: how to remake the System ...................cssscesessiscssseesenes mk(8) 
Mkdir: Make @ GIPECtOLY. uu... cescstcessscectseeereseeseseeees mkdir(1) 
mkfs: construct a fil SYStOM. .............cessscsscesseecstesseseseeees mkfs(1M) 
mknod: build Special fil€. 0.0.0... cesssccesseeeccereeceesseeessseersees mknod(1M) 
mknod: make @ GireCtOry, OF A ...........s:sccccssesscrsssssssstecesesnens mknod(2) 
mkstr: create AN EFOr MESSAGE .............cscsseccsscssrsnsreesreees mkstr(1) 
mktemp: make 2 UNIQUE fiIC 0.0... ces cscstseecsessesreseeeees mktemp(3C) 
MM macro package FOF 20... ce eescesessersereercesssersensssssseees mm(7) 
mm macros and eqn delimiters. ..............cseccssssreesseeseseees mmchek(1) 
MM Macros. MM: Print OUT ...............cscessceresssessceserereeees mm(1) 
MM: print OUt COCUMENS .............cccsssseteeesscssececsessnenecsecsees mm(1) 
mm: the MM macro package fOr .......... ce eseestseeeeeteetene mm(7) 
mmehek: check USage Of MM ........... ce ccsceeseeeteeeeerseeeers mmchek(1) 
mmt, mvt: typeset docuMENtS, 0.0.0.0... ceesssceeeeessneeeestees mmt(1) 
mnttab: mounted file SyStOM 0.0.00... cee cceseseesseeesereeseres mnttab(5) 
PMATIAD TADS! « bs. ssiccsvstaicns Sesatecwbsogeractescbiws sdtoohiud ea wiideeeuesaacdeeess setmnt(1M) 
POG 5 gsc seaocy osisss Warensawassuuancn tua diaexee sateen Gaaseenctet esas towmasaecceuees chmod(1) 
OCS ITS ics oc cetae sacs ae ot soserinwasgsanes aaa iean ese eawcoteas umask(1) 
MODES: Of TNE. se isis cere tesssisstechsscntureryinadicntasaecunsecestian danced chmod(2) 
INOUCS Sac cssiess nsec ates cauassaeiastatacateatin we. caccicenonmnsatean outunay) tset(1) 
MOdeS Of a terMiMal. ...........cccsssccssssrcscsstseccssssreesesssceseeeeens getty(8) 
MOdeSt-SiIZEd PFOGPAMS. ............ccsccsssccssccsssccsseeessesssceneeees bs(1) 
modf: split into MantisSa AN ..............cssscesscessscesseesssesecens frexp(3C) 
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utime: set file access and 
touch: update access and 
profile. 
uusub: 


viewing. 

functions with optimal cursor 
mount: 

directory rmount: 

system. mount, umount: 
system rmount, rumount: 


dismount file system. 
mnittab: 

mvdir: 

cp, In, mv: copy, link or 
Iseek: 

manuscripts. 


view graphs. 
cp, In, 


graphs, and slides. mmt, 
dumpdir: print the 
i-numbers. 

mathematical text for/ eqn, 
definitions for eqn and 
uusub: monitor uucp 
/configuration file for the 


news: print 


process. 


priority. 
list. 


hosts 

hangups and quits. 

setimp, longimp: 

for the Network Operating System 
vtconf: configuration file for 
tbl: format tables for 

format mathematical text for 
table trmtab: make a new 
troff, 

constructs. deroff: remove 
null: the 


nt: line 

syscall: 

size: size of an 

find ordering relation for an 
‘find the printable strings in an 
od: 


fopen, freopen, fdopen: 
dup: duplicate an 

open: 

Openup: keep 

writing. 

and files. 

/file for the Network 

ort: 

/prtdc, prfsnap, prfpr: 

touts, terminal independent 
strespn, strtok: string 

join: relational database 
curses: screen functions with 
getopt: get 
fcnti: file control 

getopt: parse command 
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MOIficAatION TIMES. ............:cccccccssscccesccssssteeeceesesneaeasessesoorees utime(2) 
Modification times Of a fil€. ........ i ceeeeseereesserteceeeeseneneenees touch(1) 
MONITOF: PrEPAFE EXECUTION .......cccerrereseeeseeereeseertseseeees monitor(3C) 
monitor UUCP NETWOFK. ........ceree sche vegan elles token ened eects uusub(1M) 
MOO: QUESSING GAME. .........creccecsseeeteesestsesetseeteneeesaeeeesenee moo(6) 
more: file perusal filter for CRT ..........scesecesesesseesreseeeeneees more(1) 
MOTION CUPSES: SCFEEMN .0........cceceecsrcceteeetenrenes et dale enunibeseaces curses(3C) 
MOUNT a fiIG SYSTEM. ......ccscccetectesesseestseecreteetseteeerensensens mount(2) 
Mount a remote file SYSTEM .........ccccccceenterceesteeeeseetteesenens rmount(2) 
MOUNE aNd GISMOUNE filE ............. cesses cttecseeestteseneeesees mount(1M) . 
mount and disMOUNt remote FIO ............cceeereeneeererrreeeseees rmount(1) 
MOUNT: MOUNT a fil€ SYSTEM. ........... cece cetteeesterteeeeesneees mount(2) 
MOUNT, UMOUNT: MOUNT ANG ........cccccserseceerstteseesesenesseranenees mount(1M) 
Mounted file SYSTEM table. ..........ccccscsceeesesesestecssoeesens mnttab(5) 
MOVE @ GIFECHOLY. ...........scesccccsesscnsecesteesenerseteasescseeasoeeeerens mvdir(1M) 
MOVE TGS. <icsccsccccidoccvsis catsnuratesnasadivvascnsdesscanteasdsnesetesarninaraeones cp(1) 
move read/write file POinter. ...........ccsscsnsesststeeesesteeceeterenes Iseek(2) 
MS: MACTFOS fOr FOMMALRING ........ceesecsccceeteceeeesentetsneeecesenees ms(7) 
Mt: PSCUGO tape CLIVE. .......cesecssescesserrceseesreessetestseeereneensenes mt(4) 
mv: a macro package for MAKING ..........ccesesseeeseereeeeeeees mv(7) 
MV: COPY, link OF MOVE fIIOS. ..........ccccsrcenereteeeesenseeseeeees cp(1) 
MVir: MOVE A CIFECTOLY. ......ccccccsessscecsssseceessterenensseaneseesanes mvdir(1M) 
mvt: typeset GOCUMENTS, VIEW ........ ccc etceteeterersseneenes mmt(1) 
Names Of filOS ON A GUMP TAP. ...... cc eecsererceeesrsreteeeeenenes dumpdir(1m) 
Ncheck: Generate NAMES FFOM .........cerercrercerseerrsoereserseees ncheck(1M) 
Neqn, Checked: format ........csccscssesrsesseererseerecsscserserseneeeees eqn(1) 
Meqn. /Special ChALACTE? ..........ceseeereesereerorenenenreeeeneents eqnchar(7) 
OTWON cccel oi icavcl cera seshe atuttadea mectncats dunaedeeetiaatacenananarenenmenees uusub(1M) 
Network Operating System (NOS) ........ccccsscseessseeeseenees D-hosts(5) 
newagrp: log in to @ MEW GPOUP. ........sesecseeecessnenseseeteeeeeeeens newogrp(1) 
PWS TEINS: iccers aarissaseecebiccreaerdinvasenusasanctiageseanesdasenereventncers news(1) 
NEWS: PFINt NEWS ITEMS. .......cesccressesteeteseseeteeetasereeeneesereees news(1) 
nice: change priority Of A oo... eeesestetteeeteeeesenseeseeeees nice(2) 
NICE: TUN & COMMANA at LOW ..........cecceessteercreesesesesensenenaaees nice(1) 
Ni: line Numbering filter. ........... es cceteeeteesteceteeetteeesteeeenseees ni(1) 
Nlist: get ENtrieS FrOM NAME ......... cere serererereeteeeeeees nlist(3C) 
NM: Print NAME liSt. .........ccececccttetteetetserectteeeeeteseeesteeeees nm(1) 
node: enable or disable foreign ................ deicendeewerdcaasene fayaes node(1M) 
nohup: run a command IMMUNE tO .........eeeeeeeteeesteeeeees nohup(1) 
NON=1OCAl GOTO ova cgesscssavveracsutavarrereatecncctisetansecionioneaesetantianes setimp(3C) 
(NOS) /Configuration file .......cccceceseseseeesestssetereneeeseeenees D-hosts(5) 
NOS Virtual Terminal ........... ccc csscssetessscsscsssccsessesseetesenes viconf(5) 
Holl OF TOU. cescessietivichvvinctess weer test mato Lgaacttianes tbi(1) 
nroff or troff. /CHECKEG: ........cccesccseccsrseresteceesseeeeseteeesees eqn(1) 
nroff terminal/printer driver ..............cccsseee a datgais sa manoina raat trmtab(1) 
nroff: typeset Or format tOXt. 0... cccesesersteeteersteeeeeeeeees troff(1) 
NrOff/troff, tol, ANA OQ ........ccsscescsecsccssrssertsesssseeeeesteseseeees deroff(1) 
null file. ...........000 Sabi des Geen leBeeSu cathe coda ntand aanDs tae ecedasaehenswenss null(4) 
MUM: the TG TOs. accsssscevivscecaracsiasszcionscasssscauoseisicesineroeenueveeasecs null(4) 
NUMDEFING fIREL. ..........cccecesccssrcsccrcescesereceseseesneesnressseseseeees ni(1) 
numeric id of SyStOM Call. 0.0... ccc etsesrecstreceeneeenetens syscail(2) 
ODOC flO. ........scccsccscsscrcescessorsesensceoreteseesssesestcsnsneasersessncooaese size(1) 
Object library. lOrder: ..........cssseccesessestceenreecereeteeeseeeeeeeeees lorder(1) 
object, or other binary, file. ............cscscssesecsneteesrerterseseees strings(1) 
CCT CHUM D soe acca cdenct vet siwiiesscasiswaneusatusssnavecatan ce aastestaaca snes od(1) 
OG OCT CUIMD sis snecicetdsctsdinsccheedshevseeetan sas rrerpaluasenedeaieties od(1) 
ODOM OSTA xiscceceddeasscsrssscscasnadsssaxcsaiesscunstindaneetpoemeateaens fopen(3S) 
OPEN fle MESCIIPLON. 2.0... ccecsscsscesestsertetesereesnesseeereseteeeeenees dup(2) 
OPEN for reading OF WHITING. ........ccsscseersersereserssereesesesesees open(2) 
open key directories and fIOS. ............ccescesssesseceseeseteeensees openup(1) 
OPEN: OPEN for readiNg OM ........ccssccsessrereeesreesesssseeeeneenes open(2) 
openup: keep open key directories ...............cccseseeeeteees openup(1) 
Operating System (NOS) ............ cc ecesesescenseeeesteereeneseenens D-hosts(5) 
Operating SYStEM PFOfIlEl. ..........cecceesrereereesreeeeeteeeseseeeens prf(4) 
Operating SySteEM PLOfHler. ............ccccesccsseersseesseeneeeeees ea profiler(1M) 
Operation routines. MGOtO, 0.0.0... ccesccesecceesseesesstseneeteees termlib(3C) 
Operations. /StrpDrk, StrSPN, 0... cesses enteteeteeneens string(3C) 
ODOUAION. ciscesestnses nec iiik ie ones daa duenvannesaceeaucienenreetele catia egenes eres join(1) 
Optimal CUPSOF MOTION 0.0... cscs ccesesseeteeeeteteseesseeseneeteeseees curses(3C) 
Option letter frOM ALQV. ...... ce sccseesersstseeesteeteeteesteetsetseesees getopt(3C) 
ODUONS isco cistessicss toevdsiavcierisirenpsoutadivseatioanveonioun deine tattevadeaas fenti(7) 
ODT ONS) ase siscescicovessnidanains eedeanveancasssncosenvacnteriansenesaeene ska eavaatense getopt(1) 
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stty: set the 

object library. lorder: find 

a directory, or a special or 
assembler and link editor 
ecvt, fevt: 

printf, fprintf, sprint: 
miscellaneous/ acct: 

chown: change 

chown, chgrp: change 

and expand files. 

sar: system activity report 
documents. mm: the MM macro 
graphs. mv: a macro 
standard buffered input/output 
4014 terminal. 4014: 

Pp: 

process, process group, and 
getopt: 


getpass: read a 

passwd: change login 
passwd: 

/setpwent, endpwent: get 
putpwent: write 

pwck, grpck: 

several files or subsequent/ 
dirname: deliver portions of 
fgrep: search a file for a 
processing language. awk: 
signal. 

expand files. pack, 

cc, 

process. popen, 


/convert archive files from 
block. update: 

mesg: 

pt: 

acctcms: command summary from 
format. acct: 

ermo: system error messages. 
more: file 

te: 

physical memory 

phys: allow a process to access 
split: split a file into 

channel. 

tee: 

subroutines. 


images. 

Iseek: move read/write file 
to/from a process. 

pp: parallel 

data base of terminal types by 
basename, dirname: deliver 
banner: make 

logarithm, power,/ exp, log, 
/sqrt: exponential, logarithm, 


for troff. cw, checkcw: 
monitor: 

unget: undo a 

profiler. 

operating/ prfid, prfstat, 
prfsnap, prfpr: operating/ 
/prtstat, pridc, prfsnap, 
system/ prfid, prfstat, pride, 
pripr: operating/ prfid, 
define holidays and 
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Options for a terminal. ...................ccecsssscscssssscesesseseessssesseesees stty(1) 
Ordering relation fOr AM oo... csseeccssseeeressteceevevessteeseceess lorder(1) 
Ordinary fil. MKNO: MAKE ............. ce ccsetessstesceesersesesernnecs mknod(2) 
OULU UG gas ce aioe vn cs vengeance Seen coaubcnccatatianeasiaatecatntetseacss a.out(5) 
OUIPUT CONVEISION :. ss. cesiscvecsaceesevernsceisiaavinisieaestee dosaetcabbssviedi ecvt(3C) 
OUtPUt forMalters. 2.0... cesccsssecesssseccssseescesseceeseesersesssesens printf(3S) 
Overview Of ACCOUNTING ANG ............ccccccccsssssccsccecceseecececereecs acct(1M) 
owner and group Of a flO. oo... ccsssssssevessesssssssssneees chown(2) 
OWMNEGM OF QIOUD s1195 seis sssscsasecisovsioccancestclersveanateeacemcsatausmesseee® chown(1) 
pack, pcat, UNPACK: COMPFESS. ............ccecccsesctcessssserseeeees pack(1) 
ACK AGC arises cocrsc ccs seteu shee toc waseaunosrensntinnibcanterceiadeneonte sar(8) 
Package for formatting 00.0.0... cccsstesscseesseseecesssseeaeens mm(7) 
package for making View ..............:ccesscsssesssevsssscossssceesereees mv(7) 
DACKAGS. SIOIO? iiss. cxcstesscase sans csnseceaxdaarcsavecselaetarnkoreees oes stdio(3S) 
paginator for the Tektronix 0.0... ecssceesesseesesecesessesesees 4014(1) 
Parallel port interface. 0.0... cccssssssecsesssscesssrsesccessessersenens pp(4) 
parent process IDS. /Get 0.0.0... ecccessscssrtesesssetccesssssreseves getpid(2) 
Parse COMMANM OPTIONS. 0.0.0... eessesseeesessssscctecessteceseees getopt(1) 
passwd: change login password. ..............:::cccsssceessrsoseseees passwd(1) 
PASSWA: PASSWOTT fIlO. 0.0... eee seesesssesesescoeesseesesesesstesesees passwd(5) 
ASS WOU: 5 5cc ccs ctcrun settee fetes ae dsrueaashescucnsahoiteaiendicusexencosse getpass(3C) 
DSS WOM sav sriseseiis fete 2h so sac ageeccadhsaebiuveucceenes tieewtinanco-sncas veins passwd(1) 
DASSWOIO TG fe icgeseet eh ateecotinestdccaweichctesscaay sees scecenendes passwd(5) 
PASSWOT filO ENITY. oo. eeseccesecsseeeresessrsessestescesteess getpwent(3C) 
PASSWOFE flO EN. ou... ee ees ccessesssstevssecssecscstssesreceess putpwent(3C) 
password/group file CHECKEMS. ..............::ccssccessssecsceessesessseees pwck(1M) 
Paste: Merge SaMe liINES OF ............ cee cesscesssserecssesssesscensens paste(1) 
Path NAMES. HASENAME, 0.0.00... cccccccssesssecesrsescstsecvenerseees basename(1) 
PAtlEIN. GFEP, EGE, ............ccccccssssssstcccerscsepsssecceseseccesecs grep(1) 
PAtlErN SCANNING ANA ...........ecccsssssccssterseesreassecessenssseaees awk(1) 
Pause: SUSPEN PFOCeESS UNTIL ...............ccccceesssscvesseseecesseses pause(2) 
pcat, UNPACK: COMPFESS ANA ou... ees essetteeceesteeeesseenes pack(1) 
BCC: C COMIN steiccetes stant atcsaeuaee aes adenine cce(1) 
pclose: initiate VO to/frOM @ ............ccccccsssssssscssssecseesssesstneass popen(3S) 
Pd: IMSC disk Controller. .............ccssccccssscccsssccessecesecessseeseceees pd(4) 
PDP-11 to VAX-11/780 format. ...........ccccssscesssscessscesceesenes arcv(1) 
periodically update the SUPEF ...............cccccccccessecsesssscesseceers update(1M) 
permit or deNy MESSAGES. ............ceceescstesstecsseesescecssassenees mesg(1) 
DOMMULSD INGON > Ses dicisccncicosedessaesidevnnadesveudeascscdiaesiaveteeeiwiaeies ptx(1) 
PEF—PFOCESS ACCOUNTING! 0.00... cccccccccessrseccesrsseesssnseesees acctcms(1M) 
Per—-Process ACCOUNTING FIO ooo... ce csssssseseseesssesessenss acct(5) 
PEMrOr, SYS_EMTlISt, SYS_NEMT, ...........ccccceseescesscesssessenpessseeseeecs perror(3C) 
perusal filter for CRT Viewing. ..............:cccccssssecesesssreseeesees more(1) 
phototypesetter Simulator. ...............cccccssecessssecesceseseesseuaees te(1) 
phys: allow @ PrOC@SS tO ACCESS ou... eeeesssseteseesteeesseeeees phys(2) 
Physical MEMOSY 0... ccsccsesstecssssescsevecsssseessssstesessesaes phys(2) 
DIGCOS dass ctdeecscasceasscstecnndeuseasaviamnncnecesunseace stones aietacdaxtetetiaes: split(1) 
Pipe: Create AN INTEPPFOCESS ..............cesssesscessseceseeteeneseeees pipe(2) 
IDG TN ass ites Pensdesectnecaedytnds eSouseinasacsnnsies eeassdeasetseniee tee(1) 
Plot: graphics interface 00... eeccesesstsrssesssessseesesssecsees plot(3X) 
Plot: graphics interface. ................cceccssscessssesssscesssstesenssesaees plot(5) 
pnch: file format fOr Card ............ccccccssscssestssessesscssessssessesenes pneh(5) 
OUMONS coksersse eats iuaceat eter tadiciensenietcchcustad Mo caseieusuacdeese eansseadss Iseek(2) 
popen, pclose: initiate VO ou... cessescesssscssecessssssesessessees popen(3S) 
DONT IMG ACE s. icsar sac sees ceadentiaccsecciaiedencdzsasaneceseapeozenesavers pp(4) 
BOM MVIV DO: sanconisisartereticescaanccancsecddcosiaide coc wleegomsdaaeeoeee ttytype(5) 
POrtions Of Path NAMES. ou... ccssssetccesetsesvesseesereeceseeees basename(1) 
DOSIOIS «= sessieys vised dans stare sceesrandarcualec tas va dsuternseatuaeas caectealouetns banner(1) 
POW, Sit: ExPONENtial, ................ccsessscsssevesssstsecceesseecvevsssseess exp(3M) 
POWEr, SQUALE FOOT FUNCTIONS. ..............cscscessessevessssereeecesoves exp(3M) 
pp: parallel port interface. ........... ee cessesssscessccessseecseceesvees pp(4) 
PF POE MOSS sce esvacenceeieiresssivsdariteoniaaslee asin aeachdc aise eon: pr(1) 
Prepare Constant—Width text ...........cccesssccccersseerecesessseessseeeees cw(1) 
Prepare EXECUTION PLrOfile. 0.0.0... ccecesccsecsssesssscesserescssesecers monitor(3C) 
previous get of an SCCS fil€. oo... cececcccescceceseeeees cea unget(1) 
Prf: Operating SYSTEM ............cccccsccessscsscsessssssssesscersccessetseecs prf(4) 
OMT: PMSMAD;, DION ocesicsisesncceesscaskeseshevece vavegerteuse see¥icaassece profiler(1M) 
prid:: pristat, DWC), eve. ccissacsisiewccacoartiedia serie Muweshemdevews profiler(1M) 
Prfpr: Operating SYSTEM .............ccscsssssscsesccsesesesseaecestceesees profiler(1M) 
Prisnap, prfpr: Operating ................cccssscsscssecesscscessesceccceencanes profiler(1M) 
pristat, pridc, prismap, ..............cccccccccscsssssccsssssecscsessrssceseees profiler(1M) 
prime time for ACCOUNTING. ..............ecceecsecseecsssecesseeeseeteeceees holidays(5) 
2.49 = March 1984 
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types: 

prs: 

date: 

cal: 

editing activity. sact: 

man: 

Cat: concatenate and 

pr: 

bbanner: 

nm: 

uname: 

news: 

with the MM macros. mm: 
printenv: 

file(s). acctcom: search and 
dump tape. dumpdir: 
names. id: 

vpmtrace: load the ICP; 
diction: 

or other/ strings: find the 
environment. 

bbanner: print large banner on 
ip: line 

Ipd: line 

Ipr: tine 

output formatters. 

nice: run a command at low 
nice: change 

exit: terminate 

fork: create a new 

kill: terminate a 

nice: change priority of a 
wait: await completion of 
errors. errpt: 

acct: enable or disable 
acctprc: 

acctcom: search and print 
times. times: get 
initialization. init: 

/getpgrp, getppid: get process, 
setpgrp: set 

process group, and parent 
lock: lock a 

kill: send a signal to a 
pclose: initiate I/O to/from a 
getpid, getpgrp, getppid: get 
ps: report 

times: get process and child 
phys: allow a 

wait: wait for child 

ptrace: 

pause: suspend 

list of file systems 

to a process or a group of 
shutdown: terminate all 
awk: pattern scanning and 
icp: Intelligent Communications 
imsp: Intelligent Mass Storage 
m4: macro 

alarm: set a 


profile. 

monitor: prepare execution 
profil: execution time 

prof: display 

environment at login time. 
orf: operating system 
prfpr: operating system 
dnid: download 

shell, the standard command 
xstr: extract strings from C 
vpm: The Virtual 
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primitive system data tyP@S. ou... cee ccesteneeeeessreeeerees types(7) 
OPINTAN: SGCS MO x cticcisccnioastcveusecteniasesetearss ia neelncacenestuetie prs(1) 
Print AN Set the ate. ..........cecccssscsssserscteeecseteesecseeesees date(1) 
Orinit CAlGNOAN, | aceveakss ccscevsersedscugs pttiencrceceevsteptunngaeeansemnenedie cal(1) 
print current SCCS fil@ oo... eccesceescserreeceeseaeeeseeesseereeeeees sact(1) 
print entries In this MANUAl. oo... cc eeeereeseeseeseeeeees man(1) 
DPAL MGS - siscexsshcces rie sevestsloeasscadacedea es dgncremensonunenrareaniesevee cat(1) 
VINE MOS i. oxi cs puics say et snevectsinasrapcrsecaniearnssn cas tcigtere tenant Moaneeus pr(1) 
print large banner On printer. oes cecseteeesseeneneeerenes bbanner(1) 
Drint NAMES MBI... iscsciascxesasiuts fuavedearanerscorsteiaedeaslysbavsiceneduieien nm(1) 
print name of current UNIX. eects ceessreeseeeeees uname(1) 
DrINt NEWS MEMS. ......... ce eceteetceteseeecseeceecreeeseesseessessesones news(1) 
print out documents formatted 0.0... ce ecesctes cee seeeenees mm(1) 
print out the ENVIFONMENt. ........... ee eccesesecstenccseeeeesereeens printenv(1) 
PFINt PFOCESS ACCOUNTING .......... cee eecceecesceeseesetseeesneestaees acctcom(1) 
print the names of fIlOS OM 2 oo... cece ceeeecteseeeessesencenee dumpdir(1m) 
print user and group IDs and ......... ee dc eatisunaeataniens id(1) 
print VPM traces. /Vpmsnap, ..............:cecsecceeseseteeeseeesnsenes vpmstart(1C) 
PAINT WOFY SENTENCES oo... cee ecccesrenereeteseersesesereeeeens diction(1) 
printable strings in AN ODjSCt, on... cee cette reseteeeeeeneneees strings(1) 
DIINTENV: Print OUT THE 0... ects tettertecteesessteeenseeereees printenv(1) 
OOUINGN Sc cerns taceti neascacearigamesromnansson inn avemialediws Matenennaceess bbanner(1) 
OMUIMGE cis sdsccecsensstaceeetncciateoccasynicntoaseatentots Gilaniorns dageeinsimeataaes Ip(4) 
Drinter GASMON » 26.5. cieranniuisd ctiaannacnines Ipd(1c) 
DIINTOr SPOOIEN. cisicscnisveeisnccwcssdssscecasucsdondeserionescedennssanascscanceeus Ipr(1) 
printf, fprintf, sprintf: .......... Soseceiseiane saat eosiee tedehoesererreces printt(3S) 
SOTOTIG 5 sso celts tasct ch sedi ancal eves aol spcuewate as tuners aee.tea tee OE nice(1) 
Driority Of & PFOCESS. ........ ce ceseecessecssnecetereesecereseseesnesneesons nice(2) 
OCOSS 2 sah sechccereises aa ares cspeenseatieas sash soeateadaceta re aermataons exit(2) 
DIOCOSS iiceridicei aser eeierente eee fork(2) 
DIOCESE s-anicarcistitetreinaulnena dd essndenisosssiensdennipaamanenteinaen Kill(1) 
POCO S Ss cissiscs vanes ee ices tua ctaice can saweap inne sgenornitcccntaccuvounas enone taees nice(2) 
DIGCOSS ©. sociestasscicsnstve ture boies eieara ier aes diate canteenipaiveds wait(1) 
process a report Of lOQGe” 20... eect ceteesetsesesseseeeenes errpt(1M) 
DIOCOSS ACCOUMIING: sici2 ccc te incastineniesceesticenicer a Guspeeanseintuecens acct(2) 
DFOCESS ACCOUNTING, ..........ccccscsceecesececessesserseeeeeeceeeseenenaeeees acctprc(1M) 
PFOCESS ACCOUNTING fIIE(S). 0... ec eeescetsecessecseteeeeseeteeeses acctcom(1) 
process and Child Process ............cecseseeseeteesreeseecneeseees times(2) 
DTOCESS: COMO) & essciecsssdiusts hacasioves sadloessencasasveudreveuaieanesiadtones init(8) 
PFOCESS GFOUP, ANd PAPENt uuu... eee et ceteereteeteteeeeneetees getpid(2) 
DIOCRES GIOUD 1D ii sisinvicests Aarcancesscredstensnscrareresaasannaeraveuabieds setpgrp(2) 
process IDS. /Get ProCeSs, 0.0... cece sseeeeetteessetseeeneees getpid(2) 
DIOCOSS IM: MOMONY: ssecsisccrist sanssescsccncascasessestneres Ries oteesvarces lock(2) 
PFOCESS OF A GFOUP Off oo... ee eesseeseseecereeeeersseeesseeesoneeees kill(2) 
DIOCESES: BODEN, = cacicscidescrscinceincss ede tro races oennnves popen(3S) 
PFOCESS, PFOCESS GFOUP, ANA! 000.00... cceesseetteeeeseneeneees getpid(2) 
DIOCESS STRAUS sexs censincdaunsnsnireniiyaadececesnscpsetuueus ys von tesavsanstasteh ps(1) 
DIOCESS TMNOS.seiesiiss ccssctidsceseqorteteciisrncnrtetictssnamneaains times(2) 
process to access physical MEMOSY ..............ceceseeeseeseeee phys(2) 
Process tO SOP OF terMiMate. 0... ccs cccessteeceeeseesoeees wait(2) 
DIOCOSS ACOs ease ceciesiac css tizstssarevestecteesdasccastharsteceniataapianattnec ptrace(2) 
Process UNI] Signal. ..............cssscscscrcccsstsscseccesseeseessresesseees pause(2) 
processed by fsck. checklist: ...............cscsssscccsssescssesseeeses checklist(5) 
Processes. /SENd a SIGMA ......... cect cesssesseeseesssseeenes kill(2) 
DIOCESSING: iiscisisessiscsncei ont ccescxecseuss estas eateries tvanease shutdown(8) 
PFOCESSING IANQUAGE. ...........cecessecssccssseceteessteesesseeessesseeseeees awk(1) 
PYOCOSSON: cisics tas vssccseaeiitecdsseveseeturtucss i ie eansnaanaleneinenatemeaciadve icp(4) 
PTOCOSSON. sasiacivpseces pansnssparvsace<cvcnsnpeeavandentneatansdeta vain ee imsp(4) 
DIOCOSSON 5 scsteseisds dadeortaiet sis vein aetectimtice amines m4(1) 
PFOCESS’S AAPM COCK. 00... ccsescssceessteesserctecesstssesteessseeeees alarm(2) 
prof: display profile data. 0... ee ccsccteseeteseseeeseeesseeenes prof(1) 
DrOfil: EXECUTION HME 2.0.0.0... cesccesessseeeesteseeeecessteeseseseseeeees profil(2) 
EOFONIG & icicbaitesunssscudeernnateediuin arse ates adits amnicnsmaumueneaes monitor(3C) 
OVOMG : feclvaticeesn listen atarmracuasinievotnorescdeaet: ebigaesdvguianelanes profil(2) 
PFO Catal icine cess sets caste ccswin ented ceca nsuantavasaniectte Meleeroraitivs prof(1) 
Profile: SEttING UP AN oo... ce sccetcscsetcee eesesseessseeeeseseees profile(5) 
PROT = bacats veceseavarusrannees nse oetee acta deeseaean ives aaseatnenecreuees prt(4) 
profiler. /pridic, prismap, ........... cc escceseceseecesseesersesssesseees profiler(1M) 
DIOGIAM THOS. ceiicscscccsstistescencscinideusatis vaveutacelashs aviaeneatasdooeast dnid(1m) 
programming language. SN: .......... ccs ecsessereceteseveeeenees sh(1) 
programs to implement shared/ ........... cee ececesseeneeeseees xstr(1) 
Protocol Machine. ...............ccssscsscsccesssssccsssccseccesseseessseseeeees vpm(4) 
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vpme: compiler for the virtual 
arithmetic: 

for reading or writing. locking: 
true, false: 


dk: 
mt: 


stream. ungetc: 

put character or word on a/ 
character or word on a/ putc, 
entry. 

stream. 

a/ putc, putchar, fputc, 

file checkers. 


qsort: 

command immune to hangups and 
generator. 

rand, srand: 

dialect. 

ratfor: 

shell script. 

getpass: 

read: 

rmail: send mail to users or 
line: 


open: open for 

exclusive file regions for 
lseek: move 

allocator. malloc, free, 
autoboot: automatic 

specify what to do upon 
from per—process accounting 
errdead: extract error 
wimpfix: manipulate wimp 
xref: cross 


reform: 

compile. 

compile/execute. regex, 
make: maintain, update, and 
expression compile/execute. 
compile and match routines. 
locking: provide exclusive file 
regex, regcmp: 

regcmp: 

match routines. regexp: 
sorted files. comm: select or 
lorder: find ordering 

join: 

strip: remove symbols and 
value, floor, ceiling, 
commands. mk: how to 
calendar: 

rmount: mount a 

rumount: unmount a 
rumount: mount and dismount 
rje: RJE 

file. rmdel: 

untink: 

rm, rmdir: 

eqn constructs. deroff: 

bits. strip: 

check and interactive 

uniq: report 

console. rjestat: RJE status 


Plexus Sys3 UNIX 


Permuted index 


Protocol MACHINE. .................ccsccesessesssccvsssesesscssscessecescsesscecees vpmc(1C) 
provide drill in MUMbE facts. 0.0... ceecescesstssssssveseeseeees arithmetic(6) 
provide exclusive file reQGiONS ..............scesssessevssscersseressssees lockf(2) 
provide truth values. .................ccccccssccescsscssscosssccsssceseesesseeees true(1) 
prs: print AN SCCS flllO. oo eecescssscscercreesseessevesseeseeens prs(1) 
PS: report PrOCeSS Status. 2.0.0.0... ccessscsseerscccscssscccesseenseenes ps(1) 
PSEUMO ISK CriVEF. .0..........cceescssssesscessscesssscesscessessessecseceeess dk(4) 
PSCUMO tape AriVEF. 0.0... cee csssssstsssssvcssescessrsscesessscsseceenes mt(4) 
pt: IMSC cartridge controller. ...........cccccccscecessecseccsssseeeeees pt(4) 
PITACE: PFOCESS tACE. ...............ssesesssnssceeseosssnesssccscecsancusseeees ptrace(2) 
Ptx: PErMUted INdOX. ..............::cccescssssecseessesecosecceceseesescsecerees ptx(1) 
push character back into input ................cccccssseccescescesseeseees ungetc(3S) 
putc, putchar, fputc, PUIW: .............ccccscsseescctsecsssessseesseeses pute(3S) 
putchar, fputc, PUTW: PUt .............cccccccstecesesstscessssssssssessees putc(3S) 
putpwent: write Password file ...........esesesssssssssssessssenseevens putpwent(3C) 
puts, fputs: Put a SITING ON @ .........cececcesescessereseseesesssssesens puts(3S) 
putw: put character Or WOrd OM ............csssescscsccccssssseeceesevens putc(3S) 
PWCK, QIFPCk: PASSWOF/GFOUP ............ccescccssestsccenssseeeseessenees pwck(1M) 
pwd: working directory NAME. .............cccccescssereesereeesesseees pwd(1) 
CSOM: GQUICKECR SOM. esisiszccistessteticencctsccstesescvencoarionaives exsucties qsort(3C) 
QUICKED SOM: 2625s ieeiecctitenn vate aceon qsort(3C) 
QUITS: MOTUD! FUP Gian ces eadcsiess Geasdecessnedondessavstisccdadoincataeess nohup(1) 
FAN, SPAN: FANGOM NUMDBET ..0............c cece ccccccseeseeveecessees rand(3C) 
random number Generator. .............ccccccscsccssssssssscsssssssecesesees rand(3C) 
ratfor: rational Fortran ................:ccccesssscesscsssccececscenssresessensns ratfor(1) 
rational Fortran dialect. 0.0.0.0... ccsssscessssscessesssseessssssseeees ratfor(1) 
FC: SySteM initialiZAtlON 220... cessceeertereeeestteeeeessteecees rc(8) 
TOA: PASSWOI. 26 5. ssscaseasxosssctstes ected Aetaasnazesisrivasceessaiens getpass(3C) 
(OAD THOM: MO: icscsesrs ciecscseodehin sana tiiatiteinaaiaaiet eaten aeameiones read(2) 
POA MAU SGN: ei cscsseivsed sauaceans iatdedi ia vaca wssavoiatedecceeasessn eve mail(1) 
FO AG CMO NING sss ctosicececcssedevsaneecscsenstigaies aausdunwetseesvotaguc dieteatues line(1) 
read: read from file. ...........cccccccssssccsscssevsssrescesssssessessccssceseees read(2) 
FOAGING OF WINING: ci isiisce cd hate eknetemenen open(2) 
reading Or writing. /Provide ................ccscccccsccccssssessssesssseeees lockf(2) 
read/write file pointer. .................:::ccssssccssssescessssersscsssesseseeees lseek(2) 
realloc, calloc: MAIN MEMOLY .............cccssccescssccsssecesseeseeees malloc(3C) 
VOD OO steers stan cevaaies ease citcavate neste acoeene aastavtangusaueentensees autoboot(8) 
receipt of a sigmal. Sigral: ................cccsssccccccecesseesessssssssenens signal(2) 
records. /COMMANA SUMMALY ...............csccccccecssssesssssssssttnens acctcms(1M) 
FECOPS FrOM GUMP. ............ccccssscrsrscscerrsseccssesscssssesecssesseeees errdead(1M) 
FOCOMGS TWIIID 5. sesacvecdeniecsostcimstlcarcsarasttacnsseeieansataetians fwtmp(1M) 
reference for C Programs. ..............ccccsssccccsseccrssccsssescessseeees xref(1) 
reform: reformat text fiIO. 2.0.00... cssssssstescescescseesssssessrenees reform(1) 
reformat text file. ............cccccccccccscsssccrtencessssessesseceseesecoecessesees reform(1) 
FEGCMP: regular ExPressiOMN ............ccssssccccsssssrcssssccesssseseees regcmp(1) 
rEGCMP: regular EXPreSSION .............ccssccccccsscecssscssssestssreenees regex(3X) 
regenerate Groups Of PrOGraMS. ...............ccccessssssseeeeeeeeees make(1) 
FEGOX, (EGCIMD: (OQUIAN 5 cecasssciisssievecrcentintessvaesceusiormnn enna regex(3X) 
regexp: regular ExpressiON ..............cssscsccsssssssssssssessnreecees regexp(7) 
regions for reading Of Writing. ........... css csssssessrtcseessseeaes lockf(2) 
FOQUIAT OXDFESSION aiisescieciccecscieccedideacececdsnnctuccosustercesnseccaveceys regex(3X) 
regular EXPreSSiON COMPLE. ...........ccccccsssscsessereteeessseceeees regcmp(1) 
regular expression Compile And ..............ccccecssssssesscssseeseeees regexp(7) 
reject LINES COMMON 10 TWO ...........ccccsctsecesessestcoeeseceessereeeees comm(1) 
relation for AN ODjOSCH .u..........c.cccssstcesssreesesssssrsesecceesesseaseess lorder(1) 
relational database OperatOF. ..............cccccsscccssssssscesesssseeees join(1) 
FEIOCATON DITS.. scsvicscvcda ocacecsdsiatsizcinciviniansatosdencslveeseiaintivouien strip(1) 
remainder functions. /absolute .................cccccscccscsecseescsesenes floor(3M) 
remake the SYStOM ANG 0.00... eee cceseesseesseeseeseeeeeeeeseeees mk(8) 
FOMINGOEr SOIVICS: 8 ivsesccsha di Wicssasedelousssniccsvecseantinvsistieenisors calendar(1) 
remote file SySteEM GirECtOLy ............ccccscsrscessessertceeeeserstsees rmount(2) 
remote file SySteM GIPECtOry uu... cece cesestcreeeeneneeseeees rumount(2) 
remote file systeM MOUNT, ..............cccccccessrssssessesesscneeeseeeees rmount(1) 
(Remote Job Entry) to IBM. .......... ecco Men surasaetebccuests rje(8) 
remove a delta from an SCCS ..... ccc cessscrceeeessseeeeenses rmde!l(1) 
FEMOVE GIPECTOLY OMIPY. 20.0... ccs cccsstceeeetsseessrsestssserceeesens unlink(2) 
remove files OF GiIrECtOTieS. .............:ccssscccesssssstnescecsesseneeees rm(1) 
remove Nroff/troff, tol, ANG ......... eee seccscessesssesstseetecceccerers deroff(1) 
remove SyMbols and relocation ..............ccccssssssssessersreereees strip(1) 
repair. /SyStOEM CONSISTENCY ..............ccccccscseseseeseseeececceceeeeeens fsck(1M) 
repeated lines in a fil. 0.0... sesesecccccsseseressscsececceceeseeseetes uniq(1) 
report and interactive Status .............cccccsscscessssecssesseserssseaes rjestat(1C) 
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blocks. df: 

errpt: process a 

sar: system activity 

: ps: 

file. uniq: 

and generate a system activity 
fseek, ftell, rewind: 

system restore. 

incremental file system 
interpreter). rsh: 

stat: data 

col: filter 

fseek, ftell, 

creat: create a new file or 
gather files and/or submit 
rje: 

IBM. 

interactive status/ rjestat: 
interactive status console. 
drive. 

directories. 

read mail. mail, 

SCCS file. 

directories. rm, 

system directory 

dismount remote file system 
chroot: change 

chroot: change 

logarithm, power, square 
expression compile and match 
terminal independent operation 
interpreter). 

remote file system rmount, 
system directory 

nice: 

hangups and quits. nohup: 
runacct: 


editing activity. 


package. 

space allocation. brk, 
formatted input conversion. 
bfs: big file 

language. awk: pattern 
stand-alone programs. 

the delta commentary of an 
comb: combine 

get: get a version of an 

prs: print an 

rmdel: remove a deita from an 
sccsfile: format of 

val: validate 
make a deita (change) to an 
sact: print current 

compare two versions of an 
undo a previous get of an 
admin: create and administer 
what: identify 

of an SCCS file. 


clear: clear terminal 

cursor motion curses: 
based on ex. vi: 

terminal session. 

system initialization shell 
program. 

bsearch: binary 

grep, egrep, fgrep: 
accounting file(s). acctcom: 
lsearch: linear 
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report number Of free ISK ...........sscscerseeereessserstesereneeneenes df(1) 
report Of logged EFTOFS. .......ccserseeeseecseesetseeeeesterseseteesens errpt(1M) 
FEPOFt PACKAGE... eescsssssserscsseseesesesssnesneteetserersereecereseseeees sar(8) 
FEPOFt PFOCESS StAtUS. oo... cscecsseresreseseeenerseetesterserssteeseees ps(1) 
report repeated lIN€S I a au... ce ceessseetesteeeereetteetestesetesenees uniq(1) 
report. timex: time a COMMANGA .........cccesreeesrenetteeteesenes timex(1) 
FEPOSITION A STEAM. 00... seceeessecssestsesetsesssetetseneeetesteteeseneenees fseek(3S) 
restor: Incremental fC 0... ee seeeceeesvessstsseeeeceresetseteeeenens restor(1M) 
FOSTOIG;. COSION? ei ccicccisiciuscvnviicgesacciareeatawnprdtnss dep itae diesestacasvaaastss restor(1M) 
restricted shell (COMMANG .......... cece sess seetceeeteeeeesseeenenees rsh(1) 
returned by stat System Call. 0.0... eects esetecentneetsreneerenes stat(7) 
FEVErSE LINC—fEEMS. ..........ccccccssseceesseeeventseessssesessssesersnaneeees col(1) 
rewind: repOSition A STEAM. ........scscsceesteteetsetretsesneeees fseek(3S) 
FEWTITE AN EXISTING OME. ........c.cccseesccsssceesteeeeesteeeesteseesenees creat(2) 
RUE jobs. SON, Gath: 0... esses seseeseseeeeseeseserssneenees send(1C) 
RJE (Remote Job Entry) to IBM. .0.........cccseeteeteeeteeeees rje(8) 
rje: RUE (Remote Job Entry) to... eecsseretterneeeeeteeneens rje(8) 
FJE Status: fODOrt AI iiss cccsdivccsaveesiesanescstasseisatsnceseoantenseaantess rjestat(1C) 
rjestat: RUE status report ANd ue cseteceeeneeeteeseeeees rjestat(1C) 
rm: Cipher Microstreamer tape ..........ccecesecsecnreeseeeseeetees rm(4) 
FM, Mir: FEMOVE FIIES OF 0... cceeeeeseeveteeececsteeesstseeeeees rm(1) 
rmail: Send Mail tO USEFS OF ou... cesses eeeveeseseereeeseeeeoes mail(1) 
rmdel: remove a delta from ath ou... ecccesssrreetessneneeees rmdei(1) 
rMadir: rEMOVE FES OF 00... ccsccessseteceeseesectscesecsessnssteaesoeneoes rm(1) 
MOUNT: MOUNt a TEMOTE FIO oes ceteettteeeeeeeteeees rmount(2) 
FMOUNt, FUMOUNE: MOUNT AN .0...... eee ceeseteteeeerenereeeeees rmount(1) 
VOOt GIPGCIONY. os sescecsecnincsiesdven aeeeieschiasterisessew i aderasdeaenes chroot(2) 
root directory for A COMMANG. ...........ccecceeescscessteecetsteeesenees chroot(1M) 
root functions. /exponential, .............. eee scsssceeseesesceteenens exp(3M) 
FOUTINES. FEGEXP: FEQUIAM 0.0... ee cecsescttetsesteeeteetesenneeees regexp(7) 
routines. /tgetstr, tgoto, tputs, ....... i tatealtes el sabisasitautatstae exenaacnunede termlib(3C) 
rsh: restricted shell (COMMANA ........... cece cccseetseesesteeneneees rsh(1) 
rumount: Mount aNd GISMOUNT 2.00.0... cee see ssnesesereeeeenees rmount(1) 
rumount: UNMOUNT a rEMoteE IIE 0. ec cssseetseteeeeenes rumount(2) 
run a command at low priority. .............0008 eles tepeininiuandenen nice(1) 
TUN & COMMAN IMMUNE tO ou... eecccccssescesteetenetsteenssteesseeses nohup(1) 
FUN dally ACCOUNUNG. casccvisstencsssncciecscideanieuvertianieeeiesiia runacct(1M) 
rUNACCT: TUN daily ACCOUNTING. ....... ce eceesesreesteecereeeenteeens runacct(1M) 
sact: print current SCCS fil€ oo... ces eeteteeeteeeeseeens sact(1) 
SAG: SySteM ACtivity GraPN. ou... eects ceeteceteseenteenes sag(1M) 
Saf: SYSteM ACtiVity FEPOFT octet ceteceeesteeeerereees sar(8) 
sbrk: change data SEGMENT ....... eee cece ceteeseteeeeereeees brk(2) 
scamif, fscanf, SSCANF: ............ccssccssecsscsssncesessnreceestecsossanenseses scant(3S) 
SCANNOM:. oo ieissisisecsaerciciseneesetstvccnsmerese aces Merona mes bfs(1) 
SCANNING ANA PPOCESSING .0.........cssseecesreesesreseesnsteeseereseeees awk(1) 
SCC: C COMPMOL fOK ....... ce cssccsssecssssecssssssssecesssecssteescecoetescees scec(1) 
SCCS delta. cdo: ChANGE ........ cc scesecsssetececseesseceseeceeeeeees cdc(1) 
SCCS deltas: a coicavsicr tice anaes eres comb(1) 
SOCS Me er sssscesiscucr snaseavncebacveestica vers sania tacvuialssaseee cddeadvtastssvesseurs get(1) 
SCCS Nei acdiscncciaaiatd census ene prs(1) 
SCCS file. ....... ST Tn ener te ee rmdel(1) 
SOCS Fe sso cclseves coher cocsscscvadecet vib chnasietiatensetaiigeat ta vecachaas sccsfile(5) 
SCCS MGs sictactiw eins mdse aan daeancniessaat val(1) 
SGCCS Mlle; delta? jasc sctcwiromnnatineiakiesncieenes delta(1) 
SCCS file editing ACtiVity. .............cecescsressseteeteceereseseeenes sact(1) 
SCCS filo. SCOOT: adi sicinccciicciasesnccicnsecdies itestentendernaseginontes sccsdiff(1) 
SCCS MO: UNGOt: iscimaiiqasinnisneaaniinimiiaiaawienns unget(1) 
SCCS Mes! iceccataw Gasteiiseaepseninei aa barnes admin(1) 
SCCS files. ........ cab atcuaniteae tupees oeeakateBunes Gees teaec tue can eee tates what(1) 
SCCSCiff: COMPAre TWO VETSIONS ........... cee eceeceetsrteeeeeeaees scecsdiff(1) 
sccsfile: format of SCCS fill. 0... eee ceseeceteeeseeseneeeeees sccsfile(5) 
screen. ......... sdieiia sah bana cheatdeae a saadaieneniesd sade ceiaaneuemta enews clear(1) 
screen functions with optimal ..............ccsscsscessseseeesreeeeeees curses(3C) 
screen-oriented display editor ............ cece ceseeeeeeeneeees vi(1) 
script: make typescript Of ............cccccssseesceeesctsseeenees epee script(1) 
SCHOU TCe caidas eae es cisenncenr ntti eeceeeohent acer a rc(8) 
sdiff: side-by-side difference 0.0... ceeeesteeeeeeeseneees sdiff(1) 
SOIC ieee cs coe deat plete deca a een canada ee a oleae bsearch(3C) 
search a file for a Pattern. oo... ec eceeteeeeeeereeeeeeeeees grep(1) 
search and print proCeSs ............ cece ceceeceeeeseeeeaaeeeeees acctcom(1) 
Search ANd UPdate. ...........c cc ccccccstscectesssersnseessteecsseeeeseeeees lsearch(3C) 
SOM: StrEAM OMiTOr. oo... ee seccesecsseceseetteectecceseceteecneetesersaes sed(1) 
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ork, sbrk: change data 

to two sorted files. comm: 
greek: 

of a file. cut: cut out 

a group of processes. Kill: 
and/or submit RJE jobs. 
mail. mail, rmail: 

diction: print wordy 

make typescript of terminal 
tset: 

stream. 

IDs. setuid, 

getgrent, getgrgid, getgrnam, 
goto. 

encryption. crypt, 

table. 


getpwent, getpwuid, getpwnam, 
login time. profile: 

group IDs. 

command programming language. 
from C programs to implement 
system: issue a 

rsh: restricted 

accounting. acctsh: 

rc: system initialization 
programming language. sh: 
csh: a 

processing. 

program. sdiff: 

login: 

pause: suspend process until 
what to do upon receipt of a 
upon receipt of a signal. 

of processes. kill: send a 
ssignal, gsignal: software 

lex: generate programs for 

tc: phototypesetter 

atan, atan2: trigonometric/ 
functions. 

size: 


an interval. 

interval. 

documents, view graphs, and 
spline: interpolate 


sno: 
ssignal, gsignal: 
qsort: quicker 
tsort: topological 
sort: 


or reject lines common to two 
message file by massaging the C 
ork, sbrk: change data segment 
fspec: format 

receipt of a signal. signal: 
gettytab: defining 

spelling errors. 

spelling errors. spell, 

spell, spellin, spellout: find 
errors. spell, spellin, 

curve. 

csplit: context 

split: 

exponent. frexp, Idexp, modf: 
pieces. 

uuclean: uucp 

Ipr: line printer 

printf, fprintf, 

power, square/ exp, log, pow, 
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Segment Space allocation. ............sceeseesereenesnessecsseerereres ork(2) 
select or reject lINCS COMMON ............scccsrssssrssessecesereseees comm(1) 
select terminal filter. 2.0.2.0... seeeersererereeee geval NavsGanaicieastas greek(1) 
selected fields Of CACH HIME 2.0.0.0... ccc ccesteseterreeeserceserenee cut(1) 
send a signal to a process Or .............. goeawtaenaiasiecede eatin eke kill(2) 
SEN, gath: gather fIIES ..............csecsccsesseneecersseeseeseteseeeres send(1C) 
send mail to users or read ............ ucueateuaeendernaueante ees: mail(1) 
SOMONCES cicixcvessvucessawiesdsdentaverccsansaceveecsesnonistess cdudetetepeseiaees diction(1) 
SESSION. SCIIPt: ........ ce ceeteeees poddaneeaaueceentocoendauvaeuiceetentens script(1) 
set terminal modes. ...............csccseees sos eu cenea tions aecouea raieaasoees tset(1) 
setbuf: assign buffering to a .....,......eessere pas one rat eats setbuf(3S) 
setgid: set user and group ....... se vccnasuacuuceseaiveagsas aiMtapistgiies setuid(2) 
setgrent, endgrent: get group/ ......... siaienuss sales ietadaawarinededss getgrent(3C) 
SetiMP, IONG|IMP: NON=-lOCAL ............ cesses ceessseeesseeseeeseetee setimp(3C) 
Setkey, Encrypt: DES? ecccicccesscccievscaseecisavtensveteoeses deditehdidatds crypt(3C) 
setmnt: establish mnittab ............... Se AusuaGeyys cudigesaateaamouanuranciead setmnt(1M) 
setpgrp: set process Group ID. ..............seocessresseseeersersoeerees setpgrp(2) 
setpwent, endpwent: get ........... ei scotls scnaeareneeeeast i Larne: getpwent(3C) 
Setting UP AN ENVIFONMENT At ................rerreereeccrsssersreorerseeeres profile(5) 
setuid, setgid: set user and ........ gevvaseaeest paceidescnahaa ei aaveanuse’ setuid(2) 
sh: shell, the standard ...............ccssesoees padlenberbervesiudvageeveseatens sh(1) 
shared strings. /extract strings ....... id ySathamipdabatase saseasoervaiessee: xstr(1) 
shell command. ..............cccscseessseees savpeandeudeldasenschsessveroiawlutes system(3S) 
shell (command interpreter). ..............sscccceresscreeees seadetare ». fsh(1) 
ShOll PIOCODUISS TOM wise cccdiscnedcccescescedetevssdscessctatessersesentesvedeees acctsh(1M) 
Shell SCD. iiss svicagasssseerseveenccsiadasecywesassias sadecuseiuatedastaveaseettess rc(8) 
shell, the standard COMMANG ............ccrscsrrceseresseeees gibasieees sh(1) 
shell with C-like syntax. ........... wsdaeuay a sianddevevalendouaceckectavenicins csh(1) 
shutdown: terminate all ................006 Sestuees gangatach ueuodadacueaeaty shutdown(8) 
side-by-side difference .............. eetlentuees sieassalskeviaveateceosuviaes sdiff(1) 
SIMON. sass caesnxsassbesunteove tesa cuneaieanadesnce sodudeidsvavasecebesacvesiuseecSive login(1) 
SIGN al. sikcicniaticmancines silwaaieecetensusestanetts peitunieeeusveclelaee pause(2) 
Signal. Signal: SPECIFY ................sscccssssssrreesconssccorsssepseseeeees signal(2) 
Signal: specify What tO dO ............cssssscccssrerccepersessesseeeeees signal(2) 
signal to a process or a group ............... pUagsthestseetusaceenscessedes kill(2) 
SIGNS. seesesscdescstevitneutdavnnierds peavelesaeds Jaciveds Coens ctsvecsivesusce ssignal(3C) 
Simple lexical taSkS. ..........ecssscsesessenens siventieanitie snbieiaaasensss lex(1) 
SIMMUMAION siis hes Udieriossenmvetcacvesermertueaves pardetisrvas tes sauewesnre te(1) 
SIN, COS, tAN, ASIN, ACOS, ...........ccscscssssssssccssssessseseessesssssesesens trig(3M) 
sinh, cosh, tanh: hyperbolic .............pcccsccsrsssees wuddedcasexexwore sinh(3M) 
size of an object file. .............cccceee jodebsapsnsne?eviceseeeescoharanusens size(1) 
size: size of an object file. .......... SJaehesesissencevets dessetenuersecseats size(1) 
sleep: SUSPeNd EXECUTION FOF .....,...secccccoees jeep eenaesstecisoenatecs sleep(1) 
sleep: suspend execution fOr ............ccssecsee wriaavenhtavsueveneaiees sleep(3C) 
slides. mmt, Mvt: tyPeSet .............cecssrvssssssssssssssscsesssessssssesens mmt(1) 
SMOOMN CUIVE. .........ccccscecssssccesscsseperereseseres udncscuasoadivsmeisece spline(1G) 
sno: SNOBOL interpreter. ...............ssccseee ae ouitea Taoeouaa yeas ene! sno(1) 
SNOBOL interpreter. ................sccse0 yaialedleui Seon sepGuuneemecnte sno(1) 
SOftware SIQNAIS. ..............ccsccsscsssceserssrecesscersessees suesswndeniies ssignal(3C) 
BOM ssasdaicectsssecdecacivtencasc unt eaiieaedeoedavascsteent eeeeeseaTeesateashies qsort(3C) 
SOM ce ckcewuistieiGudesscctecccssactetece se vecabadansutseeatessncosesntessersiens aieacee tsort(1) 
sort and/or merge files. .................cccees suis nstunsesvssusesunsuceetaas sort(1) 
sort: sort and/or Merge filOS. ...........cccccecessssesssevepecepeppesesones sort(1) 
sorted files. comm: SEICCt ..............scesseees p cuelshcaetlnhateassens comm(1) 
SOUFCE. MKStr: CrEatE AN ESLTOM .....,......ccccccsseseserrrccrcececeesees mkstr(1) 
SHACE ANOCATON: 1. sniscsecesssssrsccasevecdsvaveesacscevencseedoceisesvoctecsoses brk(2) 
SPECification in text fIIOS. ...............cccceceessensrcetesceensessvees » fspec(5) 
Specify what tO dO UPON ............cccccsssssersecesessreccesscesesrenepenes signal(2) 
speed tables for getty. ..........,......:.sc00 qieaneewineceertertuaeertace »... gettytab(8) 
spell, spellin, spellout: FIN ..............ccepecsssssssesssescecessesseseessens spell(1) 
spellin, spellout: find ................ see dekepayedvessdugtrai Aeemcuvoseiste spell(1) 
SPO COONS oasis tesucstscasest eccassaksesees ecysaasi red ieaarseaaeea oslo spell(1) 
spellout: find spelling ............... uveleediegessieapesunee seinen peraiise spell(1) 
Spline: interpolate SMOOMN .............ccccccsscsssessessereccsssssseseeeeess spline(1G) 
SOM: otek cata ce ccessen ss oreioe. c.tacavsosieonsaeiees vase deeeanlats dechacucieverss csplit(1) 
Split a file INtO PIECES. ............cccccscssssssessecessesseseseseeseees ‘seuss SPlit(1) 
Split Into MANTISSA ANC ................ccccccccsssccessssserrsecceseoeeess w... frexp(3C) 
Split: Split a fil INtO ..................cscssesersessecescsssensncencessesssaccessees split(1) - 
spool directory clean-up. .............cccccceceee suaaeanaeatasagiese esau uuclean(1M) 
SDOOIG ES  sscect itn sr dieea stein sa terveaeees Seadanesuispesasaueenatess seecheiueiseayes Ipr(1) 
sprintf: output formatters. ................escseseeees scgticeiwieimuionedess printf(3S) 
sqrt: exponential, lOGarithM, ..............ccccssseesssssssssscesecceseeenens exp(3M) 
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exponential, logarithm, power, 
generator. rand, 
conversion. scanf, fscanf, 
signais. 

control. 

interface. 

ugrow: change system 
scc: C compiler for 
package. stdio: 
language. sh: shell, the 
unixboot: UNIX 

system call. 


stat: data returned by 

ustat: get file system 

ps: report process 

stat, fstat: get file 

status report and interactive 
feof, clearerr, fileno: stream 
control. uustat: uucp 

status console. rjestat: RJE 
input/output package. 


wait for child process to 

imsp: Intelligent Mass 
strncmp, strcpy, strncpy,/ 
‘/strcpy, strncpy, strien, 
strncpy,/ strcat, strncat, 
‘/strncat, stremp, strncmp, 
/strrchr, strpbrk, strspn, 

fopen, freopen, fdopen: open a 
head: give first few lines of a 
puts, fputs: put a string on a 
setbuf: assign buffering to a 
sed: 

fflush: close or flush a 

ftell, rewind: reposition a 

get character or word from 
fgets: get a string from a 

put character or word on a 
Aeof, clearerr, fileno: 

push character back into input 
gets, fgets: get a 

puts, fputs: put a 

strspn, strcspn, strtok: 

C programs to implement shared 
strings in an object, or other/ 
implement shared/ xstr: extract 
strings: find the printable 

| relocation bits. 

/strncmp, strepy, strncpy, 
strcpy, strncpy,/ strcat, 

strcat, strncat, strcmp, 
/stremp, strncmp, strcpy, 
/strien, strchr, strrehr, 

/strncpy, strien, strchr, 

/strchr, strrchr, strpbrk, 
‘/strpbrk, strspn, strcspn, 
terminal. 

characteristics of a document 
another user. 

gath: gather files and/or 

plot: graphics interface 

intro: introduction to 

/same lines of several files or 
file. sum: 

file. 

du: 

accounting/ acctcms: command 
sync: update the 

update: periodically update the 
sync: update 
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SQUare FOOt FUNCTIONS. (SOT: 0... cccssssttccceceeessssnsseecceees exp(3M) 
SPAN: TANGOM NUMDBET ...........ccccccccsssssccessssseccesstteseeecssseneeees rand(3C) 
sscanf: formatted input .............c:cssccssssecssescsssessesesesneceesenes scanf(3S) 
ssignal, gsignal: SOftWAFrE ........... cee eecseeetersseeesecerseeeseneenes ssignal(3C) 
St: SYNCHONOUS terMiNal ou... cece cteeeceeeeeeeeeseeneeeee st(1M) 
St: SYACHFONOUS terMiNal ............... cesses sceesetetteneeseeeenees st(4) 
STACK MIE: oectccsteets accedennctrauapencaceaasteasicaanavantessoieaasetiewss ugrow(2) 
Stand-Alone PrOGramMS. ............ccccssccesssccssreccessecssseesneeeesnees scc(1) 
standard buffered input/output 2.0... ee ecteseteecee scenes stdio(3S) 
standard command programming ...............::ccssssseceesseceeees sh(1) 
Startup and boot Procedure. ou... eescssccsessseseteceeeees unixboot(8) 
Stat: data returned by Stat uo... eccessesserccsssrecessrreteesees stat(7) 
Stat, fstat: get file StatUS. 00.0.0... eects ceeceseerreeeeseeseens stat(2) 
Stat sysiomCallls s.sjsisicicite canna iennanvenccetiauen stat(7) 
STASIS > dis cacsss raizertacenecsecsetesesahecee ads eassanasenicrepasetesonaoieeres ustat(2) 
SUAUIS «va iarecenerss eterno errors tale ireevrentag ps(1) 
StAtUS sc cccsbscesssnateccrssieteseacscertaen ie acento eevee conetdonea stat(2) 
status console. rjestat: RUE oo... ce eseeetteeceeeeereesnens rjestat(1C) 
Status inquiries. ferrOr, ...........:.ccceccecstecstetseesseessesesaessaserees ferror(3S) 
Status INQUITY AND JOD ou... eceeseceesscesesstecesreesesesaeereeees uustat(1C) 
Status report AN INtErACHIVE on... ccc ecsttteceesteeerseeeeees rjestat(1C) 
Stdio: standard buffered ...............cscccccssscccsrscccssteeeseneessteeees stdio(3S) 
SUMO: SOt TING: ssi eee piencni aan stime(2) 
Stop or terminate. Wait: ............ceccttteeeeeeseeee Abasionnctieae™ wait(2) 
Storage PrOCOSSOM cia: jsiscissc eeciiesiecianessasseavereveacatssdgonvscienes imsp(4) 
Strcat, Strncat, SIPCMP, ...........cccccccsssceesssereescesessnsessseeerseesees string(3C) 
Strohr, Strrchr, StrPDrk,/ ..........:ccccssccsscsseccsseceseeeseesseeseesenees string(3C) 
SIFCMP, StINCMP, SIPCPY, «0.0... ccesscesesseseseeceentseeeeeeeeseeeeees string(3C) 
StrCPy, SINCPY, SHON! 0.0... ccccsccsssceceteeneceeecenessenseseeteeees string(3C) 
SIFCSPN, StrtOK: SIFING/ 0.0... eeeeeceeeeceeeeseeeseseseseeseesseeenes string(3C) 
SU GAIN o sis chiictactetoterie etiotsnamaarematicn ices fopen(3S) 
SWORN: cueic a acre cere eater ened ee head(1) 
SITE 5, css cid eas daca Sextecsudatelnasencsne Resto etesieaes coma es eas puts(3S) 
SUT INN ccs s eacssiesd ati vateteattnctiaccatectne errand ncasenceatan ais setbuf(3S) 
SIGAaM OGUO!. siseis Krenn andes onset ciastieiias sed(1) 
Stra: 1ClOSO:. aiesciscsseisssaartemariincnciamaawetaans fclose(3S) 
SISA: TSC 5 oo sscsicsstescaccesoscavsessarccotastsoawiereh lekeeranseretiness fseek(3S) 
stream. /getchar, fgetc, GEtW: 2.0.0... ceessscessecsteesesreeeees getc(3S) 
SUGAIM: COIS, sxsasticcsecasl sat eeicvate satay cus.antinaeteaessensunes gets(3S) 
Stream. /putchar, fpUtC, PUTW: 00... ce ececeteeceeesteeeeeees putc(3S) 
StrEAM StatUS INQUITIOS. ............c ce ceeeeeeseetscetseseesecenssonsenes ferror(3S) 
SIGAIMN:. UNG: fe asicesaiccssiatis lecieeslecstesescnesserevicsterensasesaveasiinns ungetc(3S) 
String frOM A SIPEAM, 000... ees eeseeeeeeesessectsetsssesssseeseronees gets(3S) 
StiING OM: A SIOAIN: -siscssscdesasssnsseivaccuersselecseonscdsssenovnesacbeonesnedeee puts(3S) 
string operations. /StrPDIk, ............ cc csceecsessessceesctscseeneeeees string(3C) 
Strings. /extract StrINGS FPO ..........ccceesestceeeeteetsteeeeeenneeees xstr(1) 
strings: find the printable ..............cccccsscsessecenesesereetersenees strings(1) 
StrINGS frOM C PrOGrAMS tO ...... ee cccsceceessetseescseeeeeeeees xstr(1) 
strings in an object, OF OUNEL/ ............sscesseseeeesneesteeseeees strings(1) 
Strip: FEMOVE SYMDOIS ANC ...........cescssssssessessteeeeeeesenseeees strip(1) 
Strlen, StrChr, SIITCHE,/ oo... cece cccstecssstecessceessensesseecesseneeoes string(3C) 
Strncat, StrCMP, SIFNCMP, ......... ce ceescssseesesersesseeentesseeseneeens string(3C) 
SINCMP, StPCPY, SHIMCPY,/ ........ eee ceeeeeesereeseesensesseosesteseees string(3C) 
SHINCPY, StHION, SICH! ...... cece tectenesstsesevtectestssteeeneeesees string(3C) 
Strpbrk, StPSPN, SIPCSPNA/ oo... escesscsseesetsssseessseeectsseseeees string(3C) 
Strrchr, StrPDFk, SIPSPNA/ 0... eee csectsccesesseeesesesteseeereeeens string(3C) 
SUSON; SCS; SOK coeds ciscsciccrseisesvedsesrsccscaeassdsagannnsaatetes string(3C) 
Strtok: String OPETAtONS. oo... ecccsescesssestsenseteenrettetsenees string(3C) 
Stty: Set the OPtionS fOr A oo... scesessectsereeeteeeteeseeetaseanes stty(1) 
Style: ANAlyZE SUIFACE oo... eecssesererecettereeteseetenteeeneetene style(1) 
SU: DECOME SUPEF—USEF OF ..........cccsccvesstsrssessereessesenescneenees su(1) 
SUbMIt RUE jobS. SON, ........... cc cccccssceeesstsesteesseeeereeneeens send(1C) 
SUBPOUTMES servic asd azsascvarere tenses Aotieenttes HAG anes plot(3X) 
Subroutines and librarieS. 0.0.0... cceeessecsesseseessereerseeeeees intro(3) 
subsequent lineS Of ONE fIIC. ............ceeseesercestseeteeeseeenenenes paste(1) 
SUM ANd COUNT DIOCKS I A ou... ceceecsseseereceesvenseeeseseeesenes sum(1) 
SUM: SUM ANd COUNT DIOCKS I 2... eee eceeesetereseeneneeeees sum(1) 
SUMMALIZE GISK USAGE. ...........ceececseesssstevesseecessetssecsereseeees du(1) 
SUMMary frOM PEF—PFOCESS ...........ccseccecssereesseccesseeeeseerenens acctcms(1M) 
SUDEP: DIOCK  sccckeciacel eichecsusacunasiesatsaverssegsseatteescitnons ceaesamiivanes sync(1M) 
SUPE DIOCK. ....scccrssscrossccsscossorscnscentccessnessscssaasseetssccsseooasnsenes update(1M) 
SUPEL—DIOCK. 2.0... ccssscoreceessesceserscseeccsneccessnceessssesassenesssnrsesasons sync(2) 
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su: become 

document style: analyze 
interval. sleep: 

interval. sleep: 

pause: 


swap: image of the 
swab: 


strip: remove 


st: 


st: 

csh: a shell with C-like 

call. 

system error/ perror, 

perror, sys_erriist, 

syscall: numeric id of 

rmount: mount a remote file 
rumount: unmount a remote file 
make a fast tape backup of a file 
file for the Network Operating 
mount and dismount remote file 
ugrow: change 

mnttab: mounted file system 
setmnt: establish mnttab 
master device information 

new nroff terminal/printer driver 
gettytab: defining speed 

tol: format 

tabs: set 


Ctags: create a 

a file. 

trigonometric/ sin, cos, 

sinh, cosh, 

copytape: make an image copy of a 
tp: manipulate 

foackup: make a fast 

rm: Cipher Microstreamer 

mt: pseudo 

the names of files on a dump 
tar: 

dump: incremental dump 

tp: magnetic 

tape: 


file system backup. filesave, 


programs for simple lexical 
deroff: remove nroff/troft, 
or troff. 


4014: paginator for the 
tmpfile: create a 
tmpnam: create a name for a 


base. 

ct: call 

getty: set the modes of a 
stty: set the options for a 
tabs: set tabs on a 

for the Tektronix 4014 
functions of the DAS! 450 
termcap: 

st: synchronous 

generate file name for 
greek: select 

Agetfiag, tgetstr, tgoto, touts, 
st: synchronous 
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Super—user Of ANOTHEL USEF. .............ccccceseesssecssecseccssceseeseecs su(1) 
surface characteristics Of @ ..........cccsccccssssscssssscscssscssecessees style(1) 
SUSPENA EXECUTION FOF oo... ceccsesesccscccssecssssecsesesssssesesses sleep(3C) 
SUSPENd ExECUtION FOF AN ...........cccsecsscsscsesssrsccssseesccssesees sleep(1) 
suspend process until signal. ...........cccceccccscsecssccssceesecees pause(2) 
SWAD: SWAP DYTES. ............ccccsccssecscsscssssssccssepssesscesssecssessonses swab(3C) 
SWAP QO Ge eciarivichassaustiatiavencceah cecensssenkecdstuowas al tadeindeia ness swap(4) 
SWAD DY(CS oi. cc3oissiciees cesses cactehsansscotaniede nvactctwued eeeoneoveasts swab(3C) 
Swap: image of the SWap af@@ 0.0... cc cccsscecceeeeseesceess swap(4) 
symbols and relocation bits. .............cccccccsesceccsssscesscessceaes strip(1) 
sync: update super—block. .........ccceccsccecscssscessscesssseesecs sync(2) 
Sync: update the super DIOCK. uu... ccccrsccsecerscsscesees sync(1M) 
Synchronous terminal CONPOl. ........... cee ccccsecceerscesesceseees st(1M) 
synchronous terminal interface. ...............cccccccsccecseseseees st(4) 
SVINAM § cecniscrsdisentssetninerctdotainiasinassGdsavedlshcedducninesaresuleas oct at csh(1) 
syscall: numeric id of SyStOM ......... cc ccccccscssccscesssccesseesseens syscall(2) 
SYS _EMrliSt, SYS_MEMT, OFMO: ..........cceccssccssseresccssscssccssecsesecs perror(3C) 
SYS _NGMT, EITMO: SYSTEM EFTOF/ 0.0.00... ..ccccscccecesssscsssesesscccceceees perror(3C) 
SYS CAN 6 isocsoiscaccawecaeyersantvciuus aa senuscvaresatseveioudetexceuvinloucilets syscall(2) 
SYSUSIN GUC CRON sc ccs ak san doc vd ehateealocaevecavessstseeicaseeaeeeedeweees rmount(2) 
SYSTEM GIFECHOLY oo... ceseecsssssessesescsscsssevesseccsssscssssssersnss rumount(2) 
SYSIOMN.. TOACKUD sscsesecsscciuisccenclsnevaanicvesssuieeaeseadtea enn cota needle foackup(8) 
System (NOS) ‘configuration ...........ccccccecccessscsssscssessseeees D-—hosts(5) 
SYSCEM FMOUNT, FUMOUNM: ..............ccccecssesessrceescrceecscsescceseees rmount(1) 
SYSTEM Stack liMit. ooo... ec eseccsesssteccccetssseesseseessessessneens ugrow(2) 
BOG es secessits tetas cian ass Conus tal eineadvoiantuesctsectsbas toneceaie denkebeccienndacts mnttab(5) 
ADI s Soussstesid. ts ecacescaze: co hin ateweadatreteeeoveesse eeeesusisl ieee cscs setmnt(1M) 
TADIOS “MASIOR Sas ciesescdenees sce eh visaveatanuscehs lateandedeseeveceueceeuentindt2 master(5) 
table trtab: Make A oun... eecssscestcesecerseessssscsssenseeceeeees trmtab(1) 
TaDIOS TOF GOMNY.. .x2.ciscedisestcnsheneisoeccechas adie coe gettytab(8) 
tables for nroff or troff. ...... ee ee eee toi(1) 
TADS ON @ TEFMINA”l. oo... eeeccessesscsesesseeersccessccverseseeccesaees tabs(1) 
tabs: set tabs On a terminal. ..............ccccccceccessssccsecessseseceees tabs(1) 
NAS INO 5 esses eccircesse gested etecasn cies ve coneess anne emeene ae ontca caw aenee ctags(1) 
tail: deliver the last part Of 0.0.0... ccc cccssssssrescecessseeeseeeeees tail(1) 
tan, ASIN, ACOS, AtAN, AANA: ..............ccccessescesscssesssseesersseees trig(3M) 
tanh: hyperbolic FUNCTIONS. ..............:ccsccsscsssrsetsersssevesceeees sinh(3M) 
NADG se sccnsartareaseaeasenedlaves antares ted je cavauesveneeacem net bin atoats copytape(1m) 
TADS: QICIING 5 sicics vessicasssadesvedetachevertceasaroansdasevsaseaedd foscidodevonces tp(1) 
tape backup of a file SyStOM. ...............cccccsessesesscrsecesssescers foackup(8) 
RADO FIVB 5iec nce seca can ev caslsetenadebatern ie aesaaestvantsauinesendiseeasuoths rm(4) 
TADG CNIVGD.. cecectaccesarstuiucascensnaceiiacas assanaserts cients: mt(4) 
tape. GUMPAIr: Print 0. eccsteecseecessstseessteesscesseesees dumpdir(1m) 
tape fil APCHIVEL. ..............cccccccscssssccesssreecsseessensesesssstencessoesees tar(1) 
TADO TORN ose tis ders cessasnsceaevetacincuecuaeeiabenaoneeehiractaatiousennucarens dump(5) 
TADS TOMA Sas cass ceninccerecenneecoicrccagussaecseacccecusaaeveeceutun tumedeete neds tp(5) 
TAPE MANMIPUTATION. ..............-ccccscssssereccecessesercesseseecsscenssesersess tape(1) 
tape: tape MaNIPUlATION. ...............ccccssscccssercsssetssssetssecsessaees tape(1) 
tapesave: daily/weekly UNIX 0.0... eecstsccssteecesreeestsees filesave(8) 
tar: tape fil€ APCHIVEL. 0.0... cccserecetsttcetsstcesssessessenereees tar(1) 
TASKS. 1OX: GEMETALS 20.0... esse ccssstececcssstscecessstreretersssenees lex(1) 
thl, ANA SQN CONSTTUCTS. 0.0.0... ecessrecssseerssseessssecesssersesee cs deroff(1) 
thi: format tables for Mroff .............cccsecccssesesesserecessrssessteeeees tbi{1) 
tc: phototypesetter simulator. .........,.....cccccccsssssessesssseseeecers tce(1) 
TOG. DIDS: MUNG, csisecsceseercshigsiecs sccdcsececansinasau savsetdevautonasvevasixeeas tee(1) 
Tektronix 4014 terminal. ...............cccssscsssrccessessteeseeseensseees 4014(1) 
TOMMBOPAIY: TO sieiccennsses ccs toscareseeeueePieouncoucnaaieatwne tareaeaceceten ake tmpfile(3S) 
TOMO ALY HG 55. sicsss Sesseenscciesessasisss ibcsaaveediiesaateetvewiseleereeesaeens tmpnam(3S) 
CEFN: CONVENTIONAMl MAMES. .............ccccecessccesseeeecccseessssvesescecs term(7) 
termcap: terminal capability data 0.0.0.0... eeseecceesseeeees termcap(5) . 
TOTEM sects oss ichccarts veer laces tue ess odosphaceieinestereensoannenseins ct(1C) 
(1011 | ena Oe So ne ee getty(8) 
MONIT AL:. soctee sais decal ectecsceceaotencesunlsspeuetitas lon eicseacewacmmaconwbosste stty(1) 
TOPO ALS ico css crsccacdcisscavenceatsauiscectocsuswanseveesenenss Saqesasaatemnansuete tabs(1) 
terminal. 4014: pagimator ......... ccc cscsscescsessrecceccessssneees 4014(1) 
terminal. 450: handle special ........... ee eccsssccsssrteceessereees 450(1) 
terminal capability data DAS. ...............c.cccscsseesssersccessseseees termcap(5) 
TOPIMINall COMO: sss oss acsesievedecesedisatoadseatsinrncsteccousstaoavaczaees st(1M) 
Srrmirial,.-CtOCI sss eis crac catid ci ses Sead face back caveantdoanansvctasaeouasceaaes ctermid(3S) 
TOCIMUM AY TING saci ictedet icasupnaeet censuses acasebeaantudsbeasspinceGeressnectces greek(1) 
terminal independent operation/ .................:ccssccsssccessrcsssevees termlib(3C) 
terminal interface. ..............eecssccseseeesssnsccssrcesesesesssseescsseees st(4) 
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tty: general 

tset: set 

clear: clear 

script: make typescript of 
isatty: find name of a 
ttytype: data base of 

file for NOS Virtual 

trmtab: make a new nroff 
functions of DAS! 300 and 300s 
tty: get the 

of HP 2640 and 2621-series 
kill: 

shutdown: 

exit: 

daemon. errstop: 

for child process to stop or 
tgetflag, tgetstr, tgoto, tputs,/ 
command. 

ed: 

ex: 

editor for new or casual/ edit: 
retorm: reformat 

fspec: format specification in 
/checkeq: format mathematical 
prepare constant-width 
nroff: typeset or format 
tgetstr, tgoto, tputs,/ termlib: 
termlib: tgetent, tgetnum, 
tgoto, tputs,/ termlib: tgetent, 
Agetent, tgetnum, tgetflag, 
tgetnum, tgetfiag, tgetstr, 
explain: interactive 

ttt, cubic: 

stime: set 

time: get 

time: 

system activity/ timex: 


profil: execution 
up an environment at login 


tzset: convert date and 
process times. 

update access and modification 
get process and child process 
file access and modification 
generate a system activity/ 
file. 

temporary file. 

toupper, tolower, 

popen, pcliose: initiate I/O 
translation. toupper, 

tsort: 

acctmerg: merge or add 
modification times of a file. 
character translation. 


‘tgetflag, tgetstr, tgoto, 
ptrace: process 


load the ICP; print VPM 

take a core image of the ICP and 
tr: 

tolower, toascil: character 

tan, asin, acos, atan, atan2: 
terminal/printer driver table 

- constant-width text for 
mathematical text for nroff or 
format text. 
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terminal interface. ...........ccescccccssssrresesssrsecsssssssssssescessnseeeeees tty(4) 
LOrminal MOOS’ .acsiesisccsccsseveanciieccrcscaseasaizensesvasisenraadtanssvoiveees tset(1) 
terminal SCPOON sc scscascsciccisusstasesavnieetradiescavercderinceaenaasssovandes clear(1) 
terminal SESSION. ..........cccccsssccceceetsessnesteeseseosesserersaesssesseenes script(1) 
lorminal.: yNAaMe) ceases excercqueniinaredecceasecsudeentaninss ttyname(3C) 
terminal typeS DY POrt on... ccc eeeeetestrenesertesenneeseees ttytype(5) 
Terminal vtconf: CONfIQUrATION 0... eect ceteeseeerreeeeseneees vtconf(5) 
terminal/printer driver table 0.0.0... cece eseeeeseeentseeeenes trmtab(1) 
terminals. /handie special .............. cece seeeeneeeseessetseeeees 300(1) 
TOfMINAI'S NAME). 26655 cetera a eels atneeednedsseosielan tty(1) 
terminals. /special FUNCTIONS ......... eee ee eeteeeneeeeeeeeneees hp(1) 
TOPMINAlS @ PIOCOSS:: cveciscsicesincsssdbekeceutemszodcasevsuiersiedaanovisdecccs kill(1) 
terminate all ProceSSiNg. ............ cesses eecstessseeeesasoneeees shutdown(8) 
TOMMIMALO PlOCOSS « waies cssccscesecescdiioeesaianadudaisastesnatenasntenaseeseness exit(2) 
terminate the error—lOQQing ........... cece sesteceseseteseseeeeeees errstop(1M) 
terminate. Walt: Walt .........cccessessecceeseessrereseeesescssorneneees wait(2) 
termlib: tgetent, tGCtNUM, 0.0... cecesesteeteerenetetteressecseceessees termlib(3C) 
teSt: CONCITION EVAIUATION ............cccssecsscsretre ecnesecesessaseceeoesens test(1) 
TEXT GONG! cae ses aleereieicirra stesso eased einer emotes ed(1) 
TOKE COON < sesssvinsnissstrudionmrs ceria aacarterinmneninianeey ex(1) 
text editor, variant Of th€ OX occ eceeeeeesesesteeeeeenes edit(1) 
TONE NOs: cesseeessccsteetaviadie wea ktetetecennescansiovaualsrecaceboninaspeoeaiveiss reform(1) 
TOXtTICS seen eae eee es fspec(5) 
tOxt for MTOM OF THON s.cccce veces sscesteser spsosesersaestoiaateadeacveneseaevens eqn(1) 
text for troff. CW, CHECKCW: ..........ccccccccccccesssssrtseeeccesessesseenens cw(1) 
1000 THON a occas Saini aes Goon cine troff(1) 
tgetent, tgetnum, tgetflag, ......... ce ecceerssesestessesseesneeens termlib(3C) 
tgetfiag, tgetstr, tgoto, tOUtS,/ ou... et eteeesessssseseseeeees termlib(3C) 
tgetnum, tgetflag, tgetstr, 0.0... scsccsecsrerseesteesteccteesseees termlib(3C) 
tgetstr, tgoto, touts, terminal 0... ee cesesseeeeesseeseeeens termlib(3C) 
tgoto, touts, terminal/ /tgetent, ...... A cuaadbsbuene bie auanetnaesnneatne termlib(3C) 
Thesaurus for GICTION 0.0... cceccesseesstseesssreseesetsecesseseeeees diction(1) 
HG =1AC 106s. sce sti ss csscrs sescsyceiwcccseveiatnes olaniaceetest et uannuniesaaianeaanss ttt(6) 
HIME. .......cceceees SEs wba tnsaeca aad ia euchbdaai ons bactalgu eon oui oosnca Geanatea eit stime(2) 
MING 2 ccarovestas cs escccsnasecesdoteaneacaacvtse dao ttaatn vom teirigeneeeneneene ease time(2) 
THE COMMA is cnc stirs ssxadecaginsvnesevaaned cvses oravevensaieiaeaiancenss time(1) 
time a command and generate @ oo... ccessecceseeeeeneees timex(1) 
TMS = GOES is seseaecceastaetiraaseelentioielicacaunatexcocneraneesdeustonsenas: time(2) 
TMG: OVOM Ge arc cticesieczasatitestecnessieesed acu: westhinascosue sshsucttoameetaceveteeds profil(2) 
time. profile: SOMING .iiaciiecciccciseieceseessiirtovtiodudiccienassoes profile(5) 
time: TIME @ COMMANG. ou... ccccsesscssteecersteeessteeesssseeeeens time(1) 
time to ASCII. /ASCHIME, 0.0... cece cesssecerscececessessssetsasevens ctime(3C) 
times: get process and Child 0.0.0... eee csessssteesesesseeeen times(2) 
times Of @ fil. TOUCH: 20.0... ececcsssssseseeseteeecesessssereesennes touch(1) 
MMOS MIM OS citer cs suctverosecesiascovasuseeantvertaxeronmals erin rceaaes times(2) 
HIMES UMC. SOC scr csscessteevacntecunsaues caus serwadeasverain cen seuatensucsdons utime(2) 
timex: time a COMMAN AN oo... sce ecssteesteeteeeereenes timex(1) 
tmpfile: create a teMPOFALy .............cccscsescesscetsersessseenseeees tmpfile(3S) 
tmpnam: create & MAME FOF A ou... cs tectettetteeteseeeteees tmpnam(3S) _ 
TOASCHI: CHAPACHEL/ 0.0... ...cesccsesssrcccssssrsccceesnsersssvessceeeescesssnees conv(3C) 
LO/MONT: & DIOCESE: ssccacesseeiinccccdsaavienieiadentanncadaatauamontens popen(3S) 
tolower, toascli: CNAFACTEL 0.0.0... ceecesessecseeseseseesssesseeseess conv(3C) 
TOPOlOGICGl: SOM. «saccades ica ctinserecasiteacseshicnnees carcass. Qhevtansavuaaies tsort(1) 
total ACCOUNTING FIIES. oo... cccsseteeceesserseeesessssssssensrens acctmerg(1M) 
touch: UPdate ACCESS AN ou... ee cecsccsscccestseeestssenssscssraens touch(1) 
toupper, tolower, tOASCII: ..............ccceccssssessreseesessesesceseaeees conv(3C) 
tp: magnetic tape format. ............eccsssssseeeeseccssssseseeeeeeoes tp(5) 
tp: manipulate tape archive. ou... cccecesccesssssceeseseeveens tp(1) 
tplot: graphics filters. oo... ee cssecsteestersssectsesseestsessseeees tplot(1G) 
tputs, terminal independent! ............... cece cccssscssscesteeeseseees termlib(3C) 
tr: translate Characters. 2.0... ccecsssccceseseeeeesesssseseceseeees tr(1) 
WACO. sictstsvervesea Stun encachetoenkae ude auntie cane oie eoaceainss ptrace(2) 
trace: event-—tracing Grivel. 00... ec ceccteeeceteeceseeestaeees trace(4) 
traces. /VPMSNap, VPMPACE: ............ceesccceessccssssssesseeteneses vpmstart(1C) 
transfer to a host file. iCpdMp: 00.0... ccscestsceeeeens oe icpdmp(1m) 
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troff, Nroff: tyPESEt OF oo... ecessccestecesssseessseecestseseesenes troff(1) 
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NAME 
intro - introduction to system calls and error numbers 
SYNOPSIS 
#include <errno.h> 
DESCRIPTION 
This section describes all of the system calls. Most of these calls have one or more error 
retums. An error condition is indicated by an otherwise impossible returned value. This is 
almost always -1; the individual descriptions specify the details. An error number is also made 
available in the external variable errno. Errno is not cleared on successful calls, so it should be 
tested only after an error has been indicated. 
All of the possible error numbers are not listed in each system call description because many 
errors are possible for most of the calls. The following is a complete list of the error numbers 
and their names as defined in <error.h>. 
1 EPERM Not owner 
Typically this error indicates an attempt to modify a file in some way forbidden except to 
its owner or super-user. It is also returned for attempts by ordinary users to do things 
_ allowed only to the super-user. 
2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file should exist but doesn't, or 
when one of the directories in a path name does not exist. 
3 ESRCH No such process 
No process can be found corresponding to that specified by pid in kill or ptrace. 
4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which the user has elected to catch, 
occurred during a system call. If execution is resumed after processing the signal, it will 
appear as if the interrupted system call returned this error condition. 
5 E10 1/0 error 
Some physical |/O error. This error may in some cases occur on a call following the one 
to which it actually applies. 
6 ENXIO No such device or address 
/O on a special file refers to a subdevice which does not exist, or beyond the limits of 
the device. It may also occur when, for example, a tape drive is not on-line or no disk 
pack is loaded on a drive. 
7 E2BIG Arg list too long 
An argument list longer than 5,120 bytes is presented to a member of the exec family. 
8 ENOEXEC Exec format error 
A request is made to execute a file which, although it has the appropriate permissions, 
does not start with a valid magic number (see a.out(5)). 
9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a read (respectively write) request is 
made to a file which is open only for writing (respectively reading). 
10 ECHILD No child processes 
A wait, was executed by a process that had no existing or unwaited-for child processes. 
11 EAGAIN No more processes 
A fork, failed because the system's process table is full or the user is not allowed to 
create any more processes. 
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ENOMEM Not enough space 
During an exec, brk, or sbrk, a program asks for more space than the system is able to 
supply. This is not a temporary condition; the maximum space size is a system param- 
eter. The error may also occur if the arrangement of text, data, and stack segments 
requires too many segmentation registers, or if there is not enough swap space during a 
fork. 


EACCES Permission denied 
An attempt was made to access a file in a way forbidden by the protection system. 


EFAULT Bad address 
The system encountered a hardware fault in attempting to use an argument of a system 
call. 


ENOTBLK Block device required 
A non-block file was mentioned where a block device was required, e.g., in mount. 


EBUSY Mount device busy 
An attempt to mount a device that was already mounted or an attempt was made to 
dismount a device on which there is an active file (open file, current directory, 
mounted-on file, active text segment). It will also occur if an attempt is made to enable 
accounting when it is already enabled. 


EEXIST File exists 
An existing file was mentioned in an inappropriate context, e.g., link. 


EXDEV Cross-device link 
A link to a file on another device was attempted. 


ENODEV No such device 
An attempt was made to apply an inappropriate system call to a device; e.g., read a 
write-only device. 


ENOTDIR Not a directory 
A non-directory was specified where a directory is required, for example in a path prefix 
or as an argument to chdir(2). 


EISDIR Is a directory 
An attempt to write on a directory. 


EINVAL Invalid argument 
Some invalid argument (e.g., dismounting a non-mounted device; mentioning an unde- 
fined signal in signal, or kill; reading or writing a file for which [seek has generated a 
negative pointer). Also set by the math functions described in the (3M) entries of this 
manual. This error occurs if an open of a serial port, e.g., /dev/console or /dev/ttyx, 
would exceed the maximum allowable (usually 16 or 32). 


ENFILE File table overflow | 
The system's table of open files is full, and temporarily no more opens can be accepted. 


EMFILE Too many open files 
No process may have more than 20 file descriptors open at a time. 


ENOTTY Not a typewriter 


ETXTBSY Text file busy 
An attempt to execute a pure-procedure program which is currently open tor writing (or 
reading). Also an attempt to open for writing a pure-procedure program that is being 
executed. 


EFBIG File too large 
The size of a file exceeded the maximum file size (1,082,201,088 bytes) or ULIMIT; see 
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ulimit (2). 


28 ENOSPC No space left on device | 
During a write to an ordinary file, there is no free space left on the device. 


29 ESPIPE Illegal seek 
An Iseek was issued to a pipe. 


30 EROFS Read-only file system 
An attempt to modify a file or directory was made on a device mounted read-only. 


31 EMLINK Too many links 
An attempt to make more than the maximum number of links (1000) to a file. 


32 EPIPE Broken pipe 
A write on a pipe for which there is no process to read the data. This condition normally 
generates a signal; the error is returned if the signal is ignored. 


33 EDOM Math argument 
The argument of a function in the math package (3M) is out of the domain of the func- 
tion. 


34 ERANGE Result too large 
The value of a function in the math package (3M) is not representable within machine 
precision. 
DEFINITIONS 
Process ID 


Each active process in the system is uniquely identified by a positive integer called a process 
ID. The range of this ID is from 0 to 30,000. 


Parent Process ID 


A new process is created by a currently active process; see fork(2). “ihe parent process ID of a 
process is the process ID of its creator. 


Process Group !D 
Each active process is a member of a process group that is identified by a positive integer 
called the process group ID. This ID is the process ID of the group leader. This grouping per- 
mits the signaling of related processes; see kill(2). 


Tty Group ID 
Each active process can be a member of a terminal group that is identified by a positive integer 
called the tty group ID. This grouping is used to terminate a group of related process upon ter- 
mination of one of the processes in the group; see exit(2) and signal(2). 

Real User ID and Real Group ID 
Each user allowed on the system is identified by a positive integer called a real user ID. 


Each user is also a member of a group. The group is identified by a positive integer called the 
real group ID. 


An active process has a real user ID and real group ID that are set to the real user ID and real 
group ID, respectively, of the user responsible for the creation of the process. 


Effective User ID and Effective Group ID 
An active process has an effective user ID and an effective group ID that are used to determine 
file access permissions (see below). The effective user ID and effective group 1D are equal to 
the process's real user ID and real group ID respectively, unless the process or one of its ances- 
tors evolved from a file that had the set-user-ID bit or set-group ID bit set; see exec (2). 


Super-user 


A process is recognized as a super-user process and is granted special privileges if its effective 
user ID is 0. 
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Special Processes 


The processes with a process ID of 0 and a process ID of 1 are special processes and are 
referred to as procO and proc’. 


ProcO is the scheduler. Proc? is the initialization process (init). Proc1 is the ancestor of every 
other process in the system and is used to control the process structure. 


File Name. 


Names consisting of up to 14 characters may be used to name an ordinary file, special file or 
directory. 


These characters may be selected from the set of all character values excluding 0 (null) and the 
ASCll code for / (slash). 


Note that it is generally unwise to use *, ?, [, or ] as part of file names because of the special 
meaning attached to these characters by the shell. See sh(1). 


Path Name and Path Prefix 
A path name is a null-terminated character string starting with an optional slash (/), followed by 
zero or more directory names separated by slashes, optionally followed by a file name. 


More precisely, a path name is a null-terminated character string constructed as follows: 
<path-name >::= <file-name >| <path-prefix > <file-name > |/ 
<path-prefix > ::= <rtprefix > |/<rtprefix > 
<rtprefix > ::= <dirname >/| <rtprefix> <dirname>/ 
where <file-name> is a string of 1 to 14 characters other than the ASCII slash and null, and 
<dirname> is a string of 1 to 14 characters (other than the ASCII slash and null) that names a 
directory. 


lf a path name begins with a slash, the path search begins at the root directory. Otherwise, the 
search begins from the current working directory. 


A slash by itself names the root directory. 


Unless specifically stated otherwise, the null path name is treated as if it named a non-existent 
file. 





Directory. 
Directory entries are called links. By convention, a directory contains at least two links, . and .., 
referred to as dot and dot-dot respectively. Dot refers to the directory itself and dot-dot refers 
to its parent directory. 


Root Directory and Current Working Directory. 
Each process has associated with it a concept of a root directory and a current working directory 
for the purpose of resolving path name searches. A process's root directory need not be the 
root directory of the root file system. 


File Access Permissions. 
Read, write, and execute/search permissions on a file are granted to a process if one or more of 
the following are true: 


The process's effective user ID is super-user. 


The process’s effective user ID matches the user ID of the owner of the file and the 
appropriate access bit of the “owner” portion (0700) of the file mode is set. 


The process's effective user ID does not match the user ID of the owner of the file, and 
the process's group ID matches the group of the file and the appropriate access bit of 
the “group” portion (070) of the file mode is set. 


The process's effective user ID does not match the user ID of the owner of the file, and 
the process's effective group 1D does not match the group ID of the file, and the 
appropriate access bit of the “other” portion (07) of the file mode is set. 
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Otherwise, the corresponding permissions are denied. 


NOTES 
Plexus adds the system calls lockf and ugrow and the header file syscall, which lists the 
numeric ids of system calls recognized by Plexus Sys3 UNIX. Plexus also adds rmount and 
rumount, for use with the Plexus Network Operating System (NOS). 


SEE ALSO 
intro(3). 
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NAME 
access - determine accessibility of a file 


SYNOPSIS 
int access (path, amode) 
char «path; 
int amode; 


DESCRIPTION 
Path points to a path name naming a file. Access checks the named file for accessibility 
according to the bit pattern contained in amode, using the real user ID in place of the effective 
user ID and the real group ID in place of the effective group ID. The bit pattern contained in 
amode is constructed as follows: 


04 read 

02 write 

01 execute (search) 

00 check existence of file 


Access to the file is denied if one or more of the following are true: 
A component of the path prefix is not a directory. [ENOTDIR] 


Read, write, or execute (search) permission is requested for a null path name. 
[ENOENT] 


The named file does not exist. ([ENOENT] 
- Search permission is denied on a component of the path prefix. [EACCES] 
Write access is requested for a file on a read-only file system. [EROFS] 


Write access is requested for a pure procedure (shared text) file that is being executed. 
{ETXTBSY] 


Permission bits of the file mode do not permit the requested access. [EACCES] 
Path points outside the process's allocated address space. [EFAULT] 


The owner of a file has permission checked with respect to the “owner” read, write, and execute 
mode bits, members of the file’s group other than the owner have permissions checked with 
respect to the “group” mode bits, and all others have permissions checked with respect to the 
“other” mode bits. 


RETURN VALUE 
If the requested access is permitted, a value of 0 is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


SEE ALSO 
chmod(2), stat(2). 
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NAME 





acct - enable or disable process accounting 


SYNOPSIS 
int acct (path) 
char «path; 


DESCRIPTION 
Acct is used to enable or disable the system’s process accounting routine. If the routine is 
enabled, an accounting record will be written on an accounting file for each process that ter- 
minates. Termination can be caused by one of two things: an exit call or a signal; see exit (2) 
and signal(2). The effective user ID of the calling process must be super-user to use this call. 


Path points to a path name naming the accounting file. The accounting file format is given in 
acct (5). 


The accounting routine is enabled if path is non-zero and no errors occur during the system 
call. It is disabled if path is zero and no errors occur during the system call. 


Acct will fail if one or more of the following are true: 
The effective user ID of the calling process is not super-user. [EPERM] 
An attempt is being made to enable accounting when it is already enabled. [EBUSY] 
A.component of the path prefix is not a directory. [ENOTDIR] 
One or more components of the accounting file’s path name do not exist. [ENOENT] 
A component of the path prefix denies search permission. [EACCES] 
The file named by path is not an ordinary file. [EACCES] 
Mode permission is denied for the named accounting file. [EACCES] 
The named file is a directory. [EISDIR] 
The named file resides on a read-only file system. [EROFS] 
Path points to an illegal address. [EFAULT] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
acct(1M), acct(5). 
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NAME 
alarm - set a process's alarm clock | 


SYNOPSIS 
unsigned alarm (sec) 
unsigned sec; 
DESCRIPTION 
Alarm instructs the calling process's alarm clock to send the signal SIGALRM to the Calling pro- 
cess after the number of real time seconds specified by sec have elapsed; see signal(2). 
_ Alarm requests are not stacked; successive calls reset the calling process's alarm clock. 
If sec is 0, any previously made alarm request is canceled. 
RETURN VALUE 
Alarm returns the amount of time previously remaining in the calling process's alarm clock. 
SEE ALSO 
pause(2), signal(2). 
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NAME 
brk, sbrk - change data segment space allocation 
SYNOPSIS 
int brk (endds) 
char *endds; 
char *sbrk (incr) 
int incr; 
DESCRIPTION 
Brk and sbrk are used to change dynamically the amount of space allocated for the calling 
process's data segment; see exec(2). The change is made by resetting the process's break 


value. The break value is the address of the first location beyond the end of the data segment. 
The amount of allocated space increases as the break value increases. 


Brk sets the break value to endds and changes the allocated space accordingly. 


Sbrk adds incr bytes to the break value and changes the allocated space accordingly. Incr can 
be negative, in which case the amount of allocated space is decreased. 


Brk and sbrk will fail without making any change in the allocated space if such a change would 
result in more space being allocated than is allowed by a system-imposed maximum (see 
ulimit(2)). [ENOMEM] 

RETURN VALUE 
Upon successful completion, brk returns a value of 0 and sbrk returns the old break value. Oth- 
erwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
exec(2). 
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NAME 





chdir - change working directory Xs 
SYNOPSIS 

int chdir (path) 

char «path; 
DESCRIPTION 

Path points to the path name of a directory. Chdir causes the named directory to become the 


current working directory, the starting point for path searches for path names not beginning with 
i. 


Chdir will fail and the current working directory will be unchanged if one or more of the following 
are true: 


A component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

Search permission is denied for any component of the path name. [EACCES] 
Path points outside the process's allocated address space. [EFAULT] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
ermo is set to indicate the error. 

SEE ALSO 
chroot(2). 
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NAME 
chown - change owner and group of a file 


SYNOPSIS 
int chown (path, owner, group) 
char «path; 
int owner, group; 


DESCRIPTION 
Path points to a path name naming a file. The owner ID and group ID of the named file are set 
to the numeric values contained in owner and group respectively. 


Only processes with effective user ID equal to the file owner or super-user may change the own- 
ership of a file. 


if chown is invoked by other than the super-user, the set-user-ID and set-group-ID bits of the 
file mode, 04000 and 02000 respectively, will be cleared. 


Chown will fail and the owner and group of the named file will remain unchanged if one or more 
of the following are true: 


A component of the path prefix is not a directory. [ENOTDIR] 
The named file does not exist. [ENOENT] 
Search permission is denied on a component of the path prefix. [EACCES] 


The effective user ID does not match the owner of the file and the effective user ID is not 
super-user. [EPERM] 


The named file resides on a read-only file system. [EROFS] 
Path points outside the process's allocated address space. [EFAULT] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a ‘value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
chmod(2). 
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NAME 
chroot - change root directory 


SYNOPSIS 
- int chroot (path) 
char spath; 


DESCRIPTION 


Path points to a path name naming a directory. Chroot causes the named directory to become 
the root directory, the starting point for path searches for path names beginning with /. 


The effective user ID of the process must be super-user to change the root directory. 


The .. entry in the root directory is interpreted to mean the root directory itself. Thus, .. can not 
be used to access files outside the subtree rooted at the root directory. 


Chroot will fail and the root directory will remain unchanged if one or more of the following are 
true: 


Any component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

The effective user ID is not super-user. [EPERM] 

Path points outside the process's allocated address space. [EFAULT] 


* RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
chdir(2). 
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NAME 
close - close a file descriptor 
SYNOPSIS 
int close (fildes) 
int fildes; 
DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, dup, fcnt!, or pipe system call. Close 
closes the file descriptor indicated by fildes. 
Close will fail if fildes is not a valid open file descriptor. [EBADF] 
RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
creat(2), dup(2), exec(2), fenti(2), open(2), pipe(2). 
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NAME 
creat - create a new file or rewrite an existing one 


SYNOPSIS 
int creat (path, mode) 
char «path; 
int mode; 


DESCRIPTION 
Creat creates a new ordinary file or prepares to rewrite an existing file named by the ii name 
pointed to by path. | 


lf the file exists, the length is truncated to 0 aide the mode and owner are unchanged. Other- 
wise, the file’s owner ID is set to the process's effective user ID, the file's group ID is set to the 
process's effective group ID, and the low-order 12 bits of the file mode are set to the value of 
mode modified as follows: 


All bits set in the process's file mode creation mask are cleared. See umask(2). 
The “save text image after execution bit” of the mode is cleared. See chmod(2). 


Upon successful completion, a non-negative integer, namely the file descriptor, is returned and 
the file is open for writing, even if the mode does not permit writing. The file pointer is set to the 
beginning of the file. The file descriptor is set to remain open across exec system calls. See 
fentl(2). No process may have more than 20 files open simultaneously. A new file may be 
created with a mode that forbids writing. 


Creat will fail if one or more of the following are true: 
A component of the path prefix is not a directory. [ENOTDIR] 
A component of the path prefix does not exist. [ENOENT] 
Search permission is denied on a component of the path prefix. [EACCES] 
The path name is null. (ENOENT] . 


The file does not exist and the directory in which the file is to be created does not permit 
writing. [EACCES] 


The named file resides or would reside on a read-only file system. [EROFS] 
The file is a pure procedure (shared text) file that is being executed. [ETXTBSY] 
The file exists and write permission is denied. [EACCES] 

The named file is an existing directory. [EISDIR] 

Twenty (20) file descriptors are currently open. [EMFILE] 

Path points outside the process's allocated address space. (EFAULT] 


RETURN VALUE 
Upon successful completion, a non- -negative integer, namely the file descriptor, is returned. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
close(2), dup(2), Iseek(2), open(2), read(2), umask(2), write(2). 
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NAME 
dup - duplicate an open file descriptor 


SYNOPSIS 
int dup (fildes) 
int fildes; 


DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, dup, fcnti, or pipe system call. Dup 
returns a new file descriptor having the following in common with the original: | 


Same open file (or pipe). 

Same file pointer. (i.e., both file descriptors share one file pointer.) 

Same access mode (read, write or read/write). 
The new file descriptor is set to remain open across exec system calls. See fcnti(2). 
The file descriptor returned is the lowest one available. 
Dup will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Twenty (20) file descriptors are currently open. [EMFILE] 


RETURN VALUE 
Upon successful completion a non-negative integer, namely the file descriptor, is returned. Oth- 
erwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
creat(2), close(2), exec(2), fentl(2), open(2), pipe(2). 
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NAME 


execli, execv, execle, execve, execip, execvp - execute a file 


SYNOPSIS 


int execl (path, arg0, arg1, ..., argn, 0) 

char «path, «arg0, «arg, ..., sargn; 

int execv (path, argv) 

char «path, sargv[ ]; 

int execle (path, arg0, arg1, ..., argn, 0, envp) 
char «path, «arg0, sarg1, ..., sargn, senvp[ J; 
int execve (path, argv, envp); 

char «path, sargv[ J], «envp[ J; 

int execip (file, arg0, arg1, ..., argn, 0) 

char sfile, «argO, «arg1, ..., sargn; | 

int execvp (file, argv) 

char sfile, sargv[ ]; 


DESCRIPTION 
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Exec in all its forms transforms the calling process into a new process. The new process is 
constructed from an ordinary, executable file called the new process file. This file consists of a 
header (see a.out(5)), a text segment, and a data segment. The data segment contains an ini- 
tialized portion and an uninitialized portion (bss). There can be no return from a successful 
exec because the calling process is overlaid by the new process. 


Path points to a path name that identifies the new process file. 


File points to the new process file. The path prefix for this file is obtained by a search of the 
directories passed as the environment line "PATH =" (see environ(7)). The environment is 
supplied by the shell (see sh(1)). 


ArgO, arg, ..., argn are pointers to null-terminated character strings. These strings constitute 
the argument list available to the new process. By convention, at least argO must be present 
and point to a string that is the same as path (or its last component). 


Argv is an array of character pointers to null-terminated strings. These strings constitute the 
argument list available to the new process. By convention, argv must have at least one 
member, and it must point to a string that is the same as path (or its last component). Argv is 
terminated by a null pointer. 


Envp is an array of character pointers to null-terminated strings. These strings constitute the 
environment for the new process. Envp is terminated by a null pointer. 


File descriptors open in the calling process remain open in the new process, except for those 
whose close-on-exec flag is set; see fcent!(2). For those file descriptors that remain open, the 
file pointer is unchanged. 


Signals set to terminate the calling process will be set to terminate the new process. Signals 
set to be ignored by the calling process will be set to be ignored by the new process. Signals 
set to be caught by the calling process will be set to terminate new process; see signal(2). 


If the set-user-ID mode bit of the new process file is set (see chmod(2)), exec sets the effective 
user ID of the new process to the owner ID of the new process file. Similarly, if the set-group-ID 
mode bit of the new process file is set, the effective group ID of the new process is set to the 
group ID of the new process file. The real user ID and real group ID of the new process remain 
the same as those of the calling process. 


Profiling is disabled for the new process; see profil(2). 
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The new process also inherits the following attributes from the calling process: 


nice value (see nice (2)) 

process ID 

parent process ID 

process group ID 

tty group ID (see exit(2) and signal(2)) 

trace flag (see ptrace (2) request 0) 

time left until an alarm clock signal (see alarm(2)) 
current working directory 

root directory 

file mode creation mask (see umask(2)) 

file size limit (see ulimit(2)) 

utime, stime, cutime, and cstime (see times (2)) 


Exec will fail and return to the calling process if one or more of the following are true: 
One or more components of the new process file’s path name do not exist. [ENOENT] 
A component of the new process file’s path prefix is not a directory. [ENOTDIR] 


Search permission is denied for a directory listed in the new process file's path prefix. 
[EACCES] 


The new process file is not an ordinary file. [EACCES] 
The new process file mode denies execution permission. [EACCES] 


The new process file has the appropriate access permission, but has an invalid magic 
number in its header. [ENOEXEC] 


The new process file is a pure procedure (shared text) file that is currently open for writ- 
ing by some process. [ETXTBSY] 


The new process requires more memory than is allowed by the system-imposed max- 
imum MAXMEM. [ENOMEM] 


The number of bytes in the new process's argument list is greater than the system- 
imposed limit of 5120 bytes. [E2BIG] 


The new process file is not as long as indicated by the size values in its header. 
(EFAULT] 
Path, argv, or envp point to an illegal address. [EFAULT] 


RETURN VALUE 
If exec returns to the calling process an error has occurred; the return value will be -1 and errno 
will be set to indicate the error. 


SEE ALSO 
exit(2), fork(2). 
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NAME 





exit - terminate process 


SYNOPSIS 
exit (status) 
int status; 


DESCRIPTION 
Exit terminates the calling process with the following consequences: 


All of the file descriptors open in the calling process are closed. 


if the parent process of the calling process is executing a wait, it is notified of the calling 
process's termination and the low order eight bits (i.e., bits 0377) of status are made 
available to it; see wait(2). 


If the parent process of the calling process is not executing a wait, the calling process is 
transformed into a zombie process. A zombie process is a process that only occupies 
a slot in the process table, it has no other space allocated either in user or kernel space. 
The process table slot that it occupies is partially overlaid with time accounting informa- 
tion (see <sys/proc.h >) to be used by times. 


The parent process ID of all of the calling process's existing child processes and zom- 
bie processes is set to 1. This means the initialization process (see intro(2)) inherits 
each of these processes. | 


An accounting record is written on the accounting file if the system's accounting routine 
is enabled; see acct (2). 


If the process ID, tty group ID, and process group ID of the calling process are equal, the 
SIGHUP signal is sent to each processes that has a process group ID equal to that of the 
Calling process. 





SEE ALSO 
signal(2), wait(2). 


WARNING 
See WARNING in signal(2). 
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FCNTL(2) 


fenti - file control 


SYNOPSIS 


#include <fcentl.h> 


int fentl (fildes, cmd, arg) 
int fildes, cmd, arg; 


DESCRIPTION 


Fentl provides for control over open files. Fildes is an open file descriptor obtained from a 
creat, open, dup, fentl, or pipe system call. 


The cmds available are: 


F_DUPFD 


F_GETFD 


F_SETFD 


F_GETFL 
F_SETFL 


Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or equal to arg. 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (i.e., both file descriptors share one file pointer). 
Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the same file status flags). 


The close-on-exec flag associated with the new file descriptor is set to remain open 
across exec(2) system calls. 


Get the close-on-exec flag associated with the file descriptor fildes. If the low-order 
bit is 0 the file will remain open across exec, otherwise the file will be closed upon 
execution of exec. 


Set the close-on-exec flag associated with fildes to the low-order bit of arg (0 or 1 
as above). 


Get file status flags. 
Set file status flags to arg. Only certain flags can be set; see fent!(7). 


Fenti will fail if one or more of the following are true: 
Fildes is not a valid open file descriptor. [EBADF] 
Cmd is F_DUPFD and 20 file descriptors are currently open. [EMFILE] 
Cmd is F_DUPFD and arg is negative or greater than 20. [EINVAL] | 


RETURN VALUE 


Upon successful completion, the value returned depends on cmd as follows: 
F_DUPFD A new file descriptor. 
F_GETFD Value of flag (only the low-order bit is defined). 
F_SETFD Value other than -1. 
F_GETFL Value of file flags. 
F_SETFL Value other than -1. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 


close(2), exec(2), open(2), fcntl(7). 
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NAME 
fork - create a new process 


SYNOPSIS 
int fork () 


DESCRIPTION : 
Fork causes creation of a new process. The new process (child process) is an exact copy of 
the calling process (parent process) except for the following: 


The child process has a unique process ID. 


The child process has a different parent process ID (i.e., the process ID of the parent 
process). 


The child process has its own copy of the parent's file descriptors. Each of the child's 
file descriptors shares a common file pointer with the corresponding file descriptor of the 
parent. 


The child process's utime, stime, cutime, and cstime are set to 0; see times(2). 
Fork returns a value of 0 to the child process. | 
Fork returns the process ID of the child process to the parent process. 
Fork will fail and no child process will be created if one or more of the following are true: 


The system-imposed limit on the total number of processes under execution would be 
exceeded. [EAGAIN] 


The system-imposed limit on the total number of processes under execution by a single 
user would be exceeded. [EAGAIN] 


RETURN VALUE | 
Upon successful completion, fork returns a value of 0 to the child process and returns the pro- 
cess ID of the child process to the parent process. Otherwise, a value of -1 is returned to the 
parent process, no child process is created, and errno is set to indicate the error. 


SEE ALSO 
exec(2), wait(2). 
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“— getpid, getpgrp, getppid - get process, process group, and parent process IDs 
SYNOPSIS 

int getpid () 

int getpgrp () 

int getppid () 
DESCRIPTION 

Getpid returns the process ID of the calling process. 

Getpgrp returns the process group ID of the calling process. 

Getppid returns the parent process ID of the calling process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), signal(2). 


GETUID(2) | GETUID(2) 


NAME 
getuid, geteuid, getgid, getegid - get real user, effective user, real group, and effective group IDs 


SYNOPSIS 
int getuid () 


int geteuid () 
int getgid () 
int getegid () 


DESCRIPTION 
Getuid returns the real user ID of the calling process. 


Geteuid returns the effective user ID of the calling process. 
Getgid returns the real group ID of the calling process. 
Getegid returns the effective group ID of the calling process. 


SEE ALSO 
intro(2), setuid(2). 
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NAME 
ioctl - control device 


SYNOPSIS | 
#include <sys/iocti.h> 


iocti(fildes, request, arg) 


DESCRIPTION 
loctl performs a variety of functions on character special files (devices). The writeups of various 
devices in Section 4 discuss how joct! applies to them. 


locti will fail if one or more of the following are true: 
Fildes is not a valid open file descriptor. [EBADF] 
Fildes is not associated with a character special device. [ENOTTY] 
_ Request or arg is not valid. See tty(4). [EINVAL] 


RETURN VALUE 
If an error has occurred, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
tty(4). 
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NAME 


KILL(2) 


kill - send a signal to a process or a group of processes 


SYNOPSIS 


int kill (pid, sig) 
int pid, sig; 


DESCRIPTION 


Kill sends a signal to a process or a group of processes. The process or group of processes to 
which the signal is to be sent is specified by pid. The signal that is to be sent is specified by 
Sig and is either one from the list given in signal(2), or 0. If sig is O (the null signal), error 
checking is performed but no signal is actually sent. This can be used to check the validity of 
pid. 


The effective user ID of the sending process must match the real user ID of the receiving pro- 
cess unless, the effective user ID of the sending process is super-user, or the process is send- 
ing to itself. 


The processes with a process ID of 0 and a process ID of 1 are special processes (see intro(2)) 
and will be referred to below as procO and proc? respectively. 


If pid is greater than zero, sig will be sent to the process whose process ID is equal to pid. Pid 
may equal 1. 


If pid is 0, sig will be sent to all processes excluding procO and proc? whose process group ID 
is equal to the process group ID of the sender. 


If pid is -1 and the effective user ID of the sender is not super-user, sig will be sent to all 
processes excluding procO and proc? whose real user ID is equal to the effective user ID of the 
sender. | 


If pid is -1 and the effective user ID of the sender is super-user, sig will be sent to all processes 
excluding procO and proc. 


If pid is negative but not -1, sig will be sent to all processes whose process group ID is equal to 
the absolute value of pid. 


Kill will fail and no signal will be sent if one or more of the following are true: 
Sig is not a valid signal number. [EINVAL] 
No process can be found corresponding to that specified by pid. [ESRCH] 


The sending process is not sending to itself, its effective user ID is not super-user, and 
its effective user ID does not match the real user ID of the receiving process. [EPERM] 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
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kill(1), getpid(2), setpgrp(2), signal(2). 
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NAME 
link - link to a file 


SYNOPSIS 
int link (path1, path2) 
char spath1, «path2; 


DESCRIPTION 


Path? points to a path name naming an existing file. Path2 points to a path name naming the 
new directory entry to be created. Link creates a new link (directory entry) for the existing file. 


Link will fail and no link will be created if one or more of the following are true: 
A component of either path prefix is not a directory. [ENOTDIR] 
A component of either path prefix does not exist. [ENOENT] 
A component of either path prefix denies search permission. [EACCES] 
The file named by path? does not exist. [ENOENT] 
The link named by path2 exists. [EEXIST] 


The file named by path? is a directory and the effective user ID is not super-user. 
[EPERM] 


The link named by path2 and the file named by path? are on different logical devices 
(file systems). [EXDEV] 
Path2 points to a null path name. [ENOENT] 


The requested link requires writing in a directory with a mode that denies write permis- 
sion. [EACCES] 
The requested link requires writing in a directory on a read-only file system. [EROFS] 
Path points outside the process's allocated address space. [EFAULT] 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
SEE ALSO 
link(1M), unlink(2). 
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LOCK(2) | (Plexus - MC68000 only) LOCK(2) 


NAME 
lock - lock a process in memory 


SYNOPSIS 
lock(flag) 


DESCRIPTION 
If the flag argument is non-zero, the process executing this call will not be swapped except if it 
is required to grow. If the argument is zero, the process is unlocked. This call may be executed 
only by the super-user. 


BUGS | 
Locked processes interfere with the compaction of primary memory and can cause deadlock. 
This system call is not considered a permanent part of the system. 
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NAME 
lockf - provide exclusive file regions for reading or writing 

SYNOPSIS 
lockf ( fildes, mode, size) long size; 

DESCRIPTION 
Lockf allows a specified number of bytes to be accessed only by the /ockf process. Other 
processes that attempt to lock, read, or write the locked area must sleep until the area becomes 
unlocked. 
Fildes is the word returned from a successful open, creat, dup, or pipe system call. 
Mode is zero to unlock the area. Mode is 1 or 2 to lock the area. If the mode is 1, and the area 
has some other lock on it, then the process sleeps until the entire area is available. If the mode 
is 2, and the area is locked, an error is returned; otherwise the area is locked. 
Size is the number of contiguous bytes to be locked or unlocked. The area to be locked starts at 
the current offset in the file. If size is 0, the area to end of file is locked. 
Deadlock may occur when a process controlling a locked area is put to sleep at the same time it 
is accessing another process's locked area. Thus calls to lockf, read, or write scan for a 
deadiock prior to sleeping on a locked area. An error return is made if sleeping on the locked 
error would cause a deadlock. 
Lock requests may, in whole or part, contain or be contained by a previously locked area for the 
same process. When this or adjacent areas occur, the areas are combined into a single area. 
Unlock requests may, in whole or part, release one or more locked regions controlled by the pro- 
cess. When regions are not fully released, the remaining areas are still locked by the process. 
While locks may be applied to special files or pipes, read/ write operations will not be blocked. 
Closing fildes automatically releases any locks the process has on a file. 

NOTES 
This is a Plexus command. It is not part of standard SYSTEM Ill. 

SEE ALSO 
open(2), creat(2), read(2), write(2), dup(2), close(2). 

DIAGNOSTICS 


The value -1 is returned if the file does not exist, or if a deadlock using file locks would occur. 
EACCES is returned for lock requests in which the area is already locked by another process. 
EDEADLOCK is returned by locking, read, or write if a deadlock would occur. EDEADLOCK 
will also be returned when the locktable overflows. 
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NAME 

locking - provide exclusive file regions for reading or writing 
SYNOPSIS 

locking ( fildes, mode, size) long size; 
DESCRIPTION 


Locking allows a specified number of bytes to be accessed only by the locking process. Other 
processes that attempt to lock, read, or write the locked area must sleep until the area becomes 
unlocked. 


Fildes is the word returned from a successful open, creat, dup, or pipe system call. 


Mode is zero to unlock the area. Mode is 1 or 2 to lock the area. If the mode is 1, and the area 
has some other lock on it, then the process sleeps until the entire area is available. If the mode 
is 2, and the area is locked, an error is returned; otherwise the area is locked. 


Size is the number of contiguous bytes to be locked or unlocked. The area to be locked starts at 
the current offset in the file. If size is 0, the area to end of file is locked. 


Deadlock may occur when a process controlling a locked area is put to sleep at the same time it 
is accessing another process's locked area. Thus calls to locking, read, or write scan for a 
deadlock prior to sleeping on a locked area. An error return is made if sleeping on the locked 
error would cause a deadlock. | 


Lock requests may, in whole or part, contain or be contained by a previously locked area for the 
same process. When this or adjacent areas occur, the areas are combined into a single area. 
Untock requests may, in whole or part, release one or more locked regions controlled by the pro- 
cess. When regions are not fully released, the remaining areas are still locked by the process. 


While locks may be applied to special files or pipes, read/ write operations will not be blocked. 
Closing fildes automatically releases any locks the process has on a file. 





NOTES | 

This is a Plexus command. It is not part of standard SYSTEM Ill. 
SEE ALSO 

open(2), creat(2), read(2), write(2), dup(2), close(2). 
DIAGNOSTICS 


The value -1 is returned if the file does not exist, or if a deadlock using file locks would occur. 
EACCES is returned for lock requests in which the area is already locked by another process. 
EDEADLOCK is returned by locking, read, or write if a deadlock would occur. EDEADLOCK 
will also be returned when the locktable overflows. | 
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NAME 
Iseek - move read/write file pointer 


SYNOPSIS 
long iseek (fildes, offset, whence) 
int fildes; | 
long offset; 
int whence; 


DESCRIPTION 
Fildes is a file descriptor returned from a creat, open, dup, or fcnt! system call. Lseek sets the 
file pointer associated with fildes as follows: 


If whence is 0, the pointer is set to offset bytes. 
If whence is 1, the pointer is set to its current location plus offset. 
If whence is 2, the pointer is set to the size of the file plus offset. 


Upon successful completion, the resulting pointer location as measured in bytes from the begin- 
ning of the file is returned. 


Lseek will fail and the file pointer will remain unchanged if one or more of the following are true: 
Fildes is not an open file descriptor. [EBADF] 
Fildes is associated with a pipe or fifo. [ESPIPE] 
Whence is not 0, 1 or 2. [EINVAL and SIGSYS signal] 
The resulting file pointer would be negative. [EINVAL] 


Some devices are incapable of seeking. The value of the file pointer associated with such a 
device is undefined. © 

RETURN VALUE 
Upon successful completion, a non-negative integer indicating the file pointer value is returned. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
creat(2), dup(2), fenti(2), open(2). 
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NAME 





mknod - make a directory, or a special or ordinary file 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 
int mknod (path, mode, dev) 
char «path; 
int mode, dev; 


DESCRIPTION 
Mknod creates a new file named by the path name apeiies to by path. The mode of the new 
file is initialized from mode, where the value of mode is interpreted as follows: 
0170000 file type (S_IFMT); one of the following: | 
0010000 fifo special (S_IFIFO) : 
0020000 character special (S_IFCHR) 
0040000 directory (S_IFDIR) 
0060000 block special (S_IFBLK) 
0100000 or 0000000 ordinary file (S_IFREG) 
0004000 set user ID on execution (S_ISUID) — 
0002000 set group ID on execution (S_ISGID) 
0001000 save text image after execution (S_ISVTX) 
0000777 access permissions; constructed from the following 
0000400 read by owner (S_IREAD) 
0000200 write by owner (S_IWRITE) 
0000100 execute (search on directory) by owner (S_ IEXEC) 
0000070 read, write, execute (search) by group . 
0000007 read, write, execute (search) by others 


Values of mode other than those above are undefined and should not be used. 


The file's owner ID is set to the process's effective user ID. The file's group ID is set to the 
process's effective group ID. 


The low-order 9 bits of mode are modified by the process's file mode creation mask: all bits set 
in the process's file mode creation mask are cleared. See umask(2). If mode indicates a block 
or character special file, dev is a configuration dependent specification of a character or block 
/(O device. If mode does not indicate a block special or character special device, dev is 
ignored. 


Mknod may be invoked only by the super-user for file types other than FIFO special. 
Mknod will fail and the new file will not be created if one or more of the following are true: 
The process's effective user ID is not super-user. [EPERM] 
A component of the path prefix is not a directory. [ENOTDIR] 
A component of the path prefix does not exist. [ENOENT] 


The directory in which the file is to be created is located on a read-only file system. 
[EROFS] 


The named file exists. [EEXIST] 
Path points outside the process's allocated address space. (EFAULT] 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
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SEE ALSO 
mkdir(1), mknod(1M), chmod(2), exec(2), umask(2), fs(5). 











March 9, 1984 | Page 2 


MOUNT (2) MOUNT (2) 


NAME 





mount - mount a file system 


SYNOPSIS 
int mount (spec, dir, rwflag) 
char sspec, dir; 
int rwflag; 

DESCRIPTION 


Mount requests that a removable file system contained on the block special file identified by 
spec be mounted on the directory identified by dir. Spec and dir are pointers to path names. 


Upon successful completion, references to the file dir will refer to the root directory on the 
mounted file system. 


The low-order bit of rwflag is used to control write permission on the mounted file system; if 1, 
writing is forbidden, otherwise writing is permitted according to individual file accessibility. 


Mount may be invoked only by the super-user. 
Mount will fail if one or more of the following are true: 
The effective user ID is not super-user. [EPERM] 
Any of the named files does not exist. (ENOENT] 
A component of a path prefix is not a directory. [ENOTDIR] 
Spec is not a block special device. [ENOTBLK] 
The device associated with spec does not exist. [ENXIO] 
Dir is not a directory. [ENOTDIR} , 
Spec or dir points outside the process's allocated address space. [EFAULT] 


Dir is currently mounted on, is someone's current working directory or is otherwise busy. 
[EBUSY] | 
The device associated with spec is currently mounted. (EBUSY] 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 
mount(1M), umount(2). 
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NAME 
nice - change priority of a process 

SYNOPSIS 
int nice (incr) 
int incr; 

DESCRIPTION 
Nice adds the value of incr to the nice value of the calling process. A process's nice value is a 
positive number for which a more positive value results in lower CPU priority. 
A maximum nice value of 39 and a minimum nice value of 0 are imposed by the system. 
Requests for values above or below these limits result in the nice value being set to the 
corresponding limit. 


Nice will fail and not change the nice value if incr is negative and the effective user ID of the 
calling process is not super-user. [EPERM] 

RETURN VALUE 
Upon successful completion, nice returns the new nice value minus 20. Otherwise, a value of 
-1 is returned and errno is set to indicate the error. 


SEE ALSO 
nice(1), exec(2). 
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NAME 
open - open for reading or writing 


SYNOPSIS . | 
#include <fentl.h> 
int open (path, oflag[, mode}) 
char «path; 
int oflag, mode; 


DESCRIPTION 
Path points to a path name naming a file. Open opens a file descriptor for the named file and 
sets the file status flags according to the value of offag. Offag values are constructed by or-ing 
flags from the following list (only one of the first three flags below may be used): 


() O_RDONLY Open for reading only. 
/} O.WRONLY Open for writing only. 
>. O_RDWR Open for reading and writing. 
O_NDELAY This flag may affect subsequent reads and writes. See read(2) and write(2). 
When opening a FIFO with OLRDONLY or OLWRONLY set: 
If O_NDELAY is set: | 


An open for reading-only will return without delay. An open for writing- 
only will return an error if no process currently has the file open for read- 
ing. 

If O_NDELAY is clear: 


An open for reading-only will block until a process opens the file for writ- 
ing. An open for writing-only will block until a process opens the file for 
reading. 








When opening a file associated with a communication line: 
If O_NDELAY is set: 
The open will return without waiting for carrier. 
If O_NDELAY is clear: 
The open will block until carrier is present. 
O_APPEND _if set, the file pointer will be set to the end of the file prior to each write. 


O_CREAT If the file exists, this flag has no effect. Otherwise, the file's owner ID is set to the 
process's effective user ID, the file's group ID is set to the process's effective 
group ID, and the low-order 12 bits of the file mode are set to the value of mode 
modified as follows (see creat(2)): 


All bits set in the process's file mode creation mask are cleared. See 


umask(2). 
The “save text image after execution bit” of the mode is cleared. See 
chmod (2). 
O_TRUNC lf the file exists, its length is truncated to 0 and the mode and owner are 
unchanged. 


O_EXCL The O_EXCL flag is undefined if O_CREAT is 0; it is defined only when O_CREAT is 
set. O_EXCL and O_CREAT both cause open to fail if the file exists. Use of both 
these flags allows a process to create a temporary file and know that it is the only 
cooperating process that has use of the file. O_LEXCL does not grant exclusive use 
of an existing file. Also, another non-cooperating process can open the file 
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without the O_EXCL bit. 

Upon successful completion a non-negative integer, the file descriptor, is returned. 
The file pointer used to mark the current position within the file is set to the beginning of the file. 
The new file descriptor is set to remain open across exec system calls. See fcnt!(2). 
No process may have more than 20 file descriptors open simultaneously. 
The path must be non-null, i.e., 0 is illegal. 
The named file is opened unless one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

O_CREAT is not set and the named file does not exist. (ENOENT] 

A component of the path prefix denies search permission. [EACCES] 

Oflag permission is denied for the named file. [EACCES] 

The named file is a directory and oflag is write or read/write. [EISDIR] 


The named file resides on a read-only file system and oflag is write or read/write. 
[EROFS] 


Twenty (20) file descriptors are currently open. [EMFILE] 


The named file is a character special or block special file, and the device associated 
with this special file does not exist. [ENXIO] 


The file is a pure procedure (shared text) file that is being executed and oflag is write or 
read/write. [ETXTBSY] 


Path points outside the process's allocated address space. [EFAULT] 
O_CREAT and O_EXCL are set, and the named file exists. [EEXIST] 


O_NDELAY is set, the named file is a FIFO, O_WRONLY is set, and no process has the 
file open for reading. [ENXIO] 
The maximum number of serial ports, e.g., /dev/ttyx, are currently open. [EINVAL] 


RETURN VALUE : 
Upon successful completion, a non-negative integer, namely a file descriptor, is returned. Oth- 
erwise, a value of -1 is returned and errno is set to indicate the error. 

NOTES 
The EINVAL message is a Plexus addition. 


SEE ALSO 
close(2), creat(2), dup(2), fenti(2), lseek(2), read(2), write(2). 
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NAME 





pause - suspend process until signal 
SYNOPSIS 
pause () 
DESCRIPTION 
Pause suspends the calling process until it receives a signal. The signal must be one that is not 
currently set to be ignored by the calling process. 
If the signal causes termination of the calling process, pause will not return. 


If the signal is caught by the calling process and control is returned from the signal catching- 
function (see signal(2)), the calling process resumes execution from the point of suspension; 
with a return value of -1 from pause and errno set to EINTR. 

RETURN VALUE 
If no error, a value of 0 is returned. 


SEE ALSO 
alarm(2), kill(2), signal(2), wait(2). 
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NAME 


phys - allow a process to access physical memory 


SYNOPSIS 


long phys (virtualpage, pagecount, physaddr) 
int virtualpage; 

long pagecount; 

long physpage; 


DESCRIPTION 


The argument virtualpage specifies a process (data-space) address range of pagecount X 4K 
bytes starting at virtual address virtualpage X 4K bytes. This address range is mapped into phy- 
sical address physpage X 4K bytes. All three arguments, virtualpage, pagecount, and phys- 
page, correspond to 4K (4096) byte pages, which is the logical and physical page size of the 
machine. If pagecount is zero, any previous mapping of virtualpage is nullified. |f pagecount is 
-1, the previous logical to physical mapping for virtualpage is returned. (In the cases where 
pagecount is 0 or -1, physaddr is ignored.) For exmaple, the call 


phys(0x10,2,0x100); 


will map virtual addresses 0x10000-0x12000 to physical addresses 0x100000-0x102000. 
This call may be executed only by the superuser. 


RETURN VALUE 


Upon successful completion, the previous page number associated with the logical page is 
returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 


BUGS 
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syslock(2) 


If an error is encountered while changing the mapping, the mapping for the valid pages may be 
changed anyway. 


This system call is obviously very machine-dependent and very dangerous. It was originally in 
VERSION 7 UNIX but was removed from SYSTEM Ill. It is not considered a permanent part of 
the system. 
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NAME : 

pipe - create an interprocess channel 

SYNOPSIS 
int pipe (fildes) 
int fildes[2]; 

DESCRIPTION 
Pipe creates an I/O mechanism called a pipe and returns two file descriptors, fildes[O] and 
fildes[1]. Fildes[0] is opened for reading and fildes[1] is opened for writing. 
Writes up to 10240 bytes of data are buffered by the pipe before the writing process is blocked. 
A read on file descriptor fildes[0] accesses the data written to fildes[1] on a first-in-first-out 
basis. 
No process may have more than 20 file descriptors open simultaneously. 
Pipe will fail if 19 or more file descriptors are currently open. [EMFILE] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 
sh(1), read(2), write(2). 


° 
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NAME 





profil - execution time profile 


SYNOPSIS 
profil (buff, bufsiz, offset, scale) 
char «buff; 
int bufsiz, offset, scale; 


DESCRIPTION 
Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the 
user’s program counter (pc) is examined each clock tick (50th second for the 28000, 64th 
second for the MC68000); offset is subtracted from it, and the result multiplied by scale. If the 
resulting number corresponds to a word inside buff, that word is incremented. _ 


The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 
0177777 (octal) gives a 1-1 mapping of pc's to words in buff; 077777 (octal) maps each pair of 
instruction words together. 02(8) maps all instructions onto the beginning of buff (producing a 
non-interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a bufsiz of 
0. Profiling is turned off when an exec is executed, but remains on in child and parent both 
after a fork. Profiling will be turned off if an update in buff would cause a memory fault. 


RETURN VALUE 
Not defined. 


NOTES 
Plexus clock tick is each 50th second for the Z8000, each 64th second for the MC68000. 


SEE ALSO 
prof(1), monitor(3C). 
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NAME 


ptrace - process trace 


SYNOPSIS 


int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 


DESCRIPTION 
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Ptrace provides a means by which a parent process may control the execution of a child pro- 
cess. Its primary use is for the implementation of breakpoint debugging; see adb(1). The child 
process behaves normally until it encounters a signal (see signa/(2) for the list), at which time it 
enters a stopped state and its parent is notified via wait(2). When the child is in the stopped 
state, its parent can examine and modify its “core image” using ptrace. Also, the parent can 
cause the child either to terminate or continue, with the possibility of ignoring the signal that 
caused it to stop. 


The request argument determines the precise action to be taken by ptrace and is one of the fol- 
lowing: 
0 This request must be issued by the child process if it is to be traced by its parent. 
It turns on the child’s trace flag that stipulates that the child should be left in a 
stopped state upon receipt of a signal rather than the state specified by func; see 
Signal(2). The pid, addr, and data arguments are ignored, and a return value is 
not defined for this request. Peculiar results will ensue if the parent does not 
expect to trace the child. 


The remainder of the requests can only be used by the parent process. For each, pid is the 
process ID of the child. The child must be in a stopped state before these requests are made. 


1, 2 With these requests, the word at location addr in the address space of the child is 
returned to the parent process. If | and D space are separated (as on the Z8000) 
request 1 returns a word from | space, and request 2 returns a word from D space. 
If | and D space are not separated (as on the 68000), either request 1 or request 2 
may be used with equal results. The data argument is ignored. These two 
requests will fail if addr is not the start address of a word, in which case a value of 
-1 is returned to the parent process and the parent's errno is set to ElO. 


3 With this request, the word at location addr in the child’s USER area in the 
system's address space (see <sys/user.h>) is returned to the parent process. 
Addresses in this area range from 0 to 2048 on the Z8000, and 0 to 4096 on the 
68000. The data argument is ignored. This request will fail if addr is not the start 
address of a word or is outside the USER area, in which case a value of -1 is 
returned to the parent process and the parent's errno is set to EIO. 


4,5 With these requests, the value given by the data argument is written into the 
address space of the child at location addr. If | and D space are separated (as on 
the Z8000), request 4 writes a word into | space, and request 5 writes a word into 
D space. If | and D space are not separated (as on the 68000), either request 4 or 
request 5 may be used with equal results. Upon successful completion, the value 
written into the address space of the child is returned to the parent. These two 
requests will fail if addr is a location in a pure procedure space and another pro- 
cess is executing in that space, or addr is not the start address of a word. Upon 
failure a value of -1 is returned to the parent process and the parent's errno is set 
to ElO. 


6 With this request, a few entries in the child’s USER area can be written. Data 
gives the value that is to be written and adoar is the location of the entry. The few 
entries that can be written are: 
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the general registers (registers 0-15) 
the program counter and FCW 


7 ~ This request causes the child to resume execution. If the data argument is 0, all 
pending signals including the one that caused the child to stop are canceled before 
it resumes execution. If the data argument is a valid signal number, the child 
resumes execution as if it had incurred that signal and any other pending signals 
are canceled. The addr argument must be equal to 1 for this request. Upon suc- 
cessful completion, the value of data is returned to the parent. This request will 
fail if data is not O or a valid signal number, in which case a value of -1 is returned 
to the parent process and the parent's errno is set to ElO. 


8 This request causes the child to terminate with the same consequences as exit(2). 


9 This request simulates a the trace bit in the Processor Status Word of the child 
and then executes the same steps as listed above for request 7. The trace bit 
causes on interrupt upon completion of one machine instruction. This effectively 
allows single stepping of the child. 

Note: the trace bit is turned off after an interrupt. 


To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent exec (2) calls. If 
a traced process calls exec, it will stop before executing the first instruction of the new image 
showing signal SIGTRAP. 
GENERAL ERRORS 
Ptrace will in general fail if one or more of the following are true: 
Request is an illegal number. [EI0] 


Pid identifies a child that does not exist or has not executed a ptrace with request 0. 
[ESRCH] 


NOTES 
Although functionally identical to the stock SYSTEM Ill system call, some architectural differences 
between Plexus and DEC hardware dictated a slightly modified implementation. 


SEE ALSO 
adb(1), exec(2), signal(2), wait(2). 
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NAME 





read - read from file 


SYNOPSIS 
int read (fildes, buf, nbyte) 
int fildes; 
char sbuf; 
unsigned nbyte; 


DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, dup, fentl, or pipe system call. 


Read attempts to read nbyte bytes from the file associated with fildes into the buffer pointed to 
by buf. 


On devices capable of seeking, the read starts at a position in the file given by the file pointer 
associated with fildes. Upon return from read, the file pointes is incremented by the number of 
bytes actually read. 


Devices that are incapable of seeking always read from the current position. The value of a file 
pointer associated with such a file is undefined. 


Upon successful completion, read returns the number of bytes actually read and placed in the 
buffer; this number may be less than nbyte if the file is associated with a communication line 
(see focti(2) and tty(4)), or if the number of bytes left in the file is less than nbyte bytes. A 
value of 0 is returned when an end-of-file has been reached. 


When attempting to read from an empty pipe (or FIFO): 
If O_NDELAY is set, the read will return a 0. 


If O_LNDELAY is clear, the read will block until data is written to the file or the file is no 
longer open for writing. 


When attempting to read a file associated with a tty that has no data currently available: 
If O_NDELAY is set, the read will return.a 0. 
lf O_NDELAY is clear, the read will block until data becomes available. 
Read will fail if one or more of the following are true: 
Fildes is not a valid file descriptor open for reading. [EBADF] 
Buf points outside the allocated address space. chee 


RETURN VALUE 
Upon successful completion a non-negative integer is returned indicating the number of bytes 
actually read. Otherwise, a -1 is returned and errno is set to indicate the error. 


NOTES 
The Plexus ICP limits nbyte to 512 for TTY devices. 


SEE ALSO 
creat(2), dup(2), fentl(2), ioctl(2), open(2), pipe(2), tty(4). 
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NAME 
rmount - mount a remote file system directory 


SYNOPSIS 
int rmount (rdir, node, dir, rwflag) 
char s«rdir, «node, dir; 
int rwflag; 
DESCRIPTION 
Rmount requests that a remote file system directory identified by rdir, at the remote system 


identified by node, be mounted on the directory identified by dir. Rdir and dir are pointers to 
path names. Node is a pointer to the remote system. 





Upon successful completion, references to the file dir will refer to the specified directory rdir at 
the remote system node. 


The low-order bit of rwflag is used to control write permission on the mounted file system; if 1, 
writing is forbidden; otherwise, writing is permitted according to individual file accessibility. 


Rmount may be invoked only by the super-user. 
Rmount will fail if one or more of the following are true: 
The effective user ID is not super-user. [EPERM] 
Any of the named files or node names does not exist. [ENOENT] 
A component of a path prefix is not a directory. [ENOTDIR] 
Dir or rdir is not a directory. [ENOTDIR] 
Rdir, node, or dir points outside the process's allocated address space. [EFAULT] 


Dir is currently mounted on, is someone's current working directory or is otherwise busy. 
[EBUSY] 
The remote directory rdir at the remote system node is currently rmounted. [EBUSY] 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. ElO is returned in errno if the rmount fails because of exces- 
sive timeouts. 

NOTES 
This command is available as part of the Plexus Network Operating System (NOS) only. 

SEE ALSO 
mount(1M), rmount(1M), umount(2), rumount(2). 
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NAME 
rumount - unmount a remote file system directory 


SYNOPSIS 
int rumount (rdir, node) 
char s«rdir; 
char «node; 


DESCRIPTION 
Rumount requests that a previously mounted remote file system directory rdir at the remote sys- 
tem node be unmounted. Adir is a pointer to a path name. Node is a pointer to the remote 
system name. After unmounting the remote file system, the directory upon which the file sys- 
tem was mounted reverts to its ordinary interpretation. 





Rumount may be invoked only by the super-user. 

Rumount will fail if one or more of the following are true: 
The process's effective user ID is not super-user. [EPERM] 
Rdir or the remote system node does not exist. [ENXIO] 


The remote file system directory rdir at the remote system node is not mounted. 
[EINVAL] 


A file on rdir is busy locally. [EBUSY] 


Rdir or node points outside the process's allocated address space. [EFAULT] 
RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
NOTES 
This command is available as part of the Plexus Network Operating System (NOS) only. 
SEE ALSO 
mount(1M), rmount (1M), mount(2), rmount(2). 
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NAME 
rmount - mount a remote file system directory 


SYNOPSIS 
int rmount (rdir, node, dir, rwflag) 
char «rdir, «node, sdir; 
int rwflag; 


DESCRIPTION 
Rmount requests that a remote file system directory identified by rdir, at the remote system 
identified by node, be mounted on the directory identified by dir. Rdir and dir are pointers to 
path names. Node is a pointer to the remote system. 


Upon successful completion, references to the file cir will refer to the specified directory rdir at 
the remote system node. 


The low-order bit of rwflag is used to control write permission on the mounted file system; if 1, 
writing is forbidden; otherwise, writing is permitted according to individual file accessibility. 


Rmount may be invoked only by the super-user. 
Rmount will fail if one or more of the following are true: 
The effective user ID is not super-user. [EPERM] 
Any of the named files or node names does not exist. [ENOENT] 
A component of a path prefix is not a directory. [ENOTDIR] 
Dir or rdir is not a directory. [ENOTDIR} 
Rdir, node, or dir points outside the process's allocated address space. [EFAULT] 


Dir is currently mounted on, is someone's current working directory or is otherwise busy. 
[EBUSY] 


The remote directory rdir at the remote system node is currently rmounted. [EBUSY] 
RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
NOTES | 
This command is available as part of the Plexus Network Operating System (NOS) only. 


SEE ALSO 
mount(1M), rmount(1M), umount(2), rumount(2). 


SETPGRP(2) SETPGAP(2) 


NAME 





setpgrp - set process group ID 
SYNOPSIS 

int setpgrp () 
DESCRIPTION 


Setpgrp sets the process group ID of the calling process to the process 'D of the calling process 
and returns the new process group ID. 


RETURN VALUE | 

Setpgrp returns the value of the new process group ID. 
SEE ALSO 

exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 
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NAME 





setuid, setgid - set user and group IDs 
SYNOPSIS 
int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 
DESCRIPTION | 
Setuid is used to set the real user ID and effective user ID of the calling process. 
Setgid is used to set the real group ID and effective group ID of the calling process. 


If the effective user ID of the calling process is super-user, the real user (group) ID and effective 
user (group) ID are set to uid (gid). 


If the effective user ID of the calling process is not super-user, but its real user (group) ID is 
equal to uid (gid), the effective user (group) ID is set to uid (gid). 
Setuid will fail if the real user (group) ID of the calling process is not equal to uid (gid) and its 
effective user ID is not super-user. [EPERM] 

RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
getuid(2), intro(2). 
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NAME 


SIGNAL (2) 


signal - specify what to do upon receipt of a signal 


SYNOPSIS 


#include <signal.h> 


int («signal (sig, func))() 


int sig; 


int («func)(); 


DESCRIPTION 


Signal allows the calling process to choose one of three ways in which it is possible to handle 
the receipt of a specific signal. Sig specifies the signal and func specifies the choice. 


Sig can be assigned any one of the following except SIGKILL: 


SIG_DFL - 
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SIGHUP 01 
SIGINT 
SIGQUIT 
SIGILL 
SIGTRAP 
SIGIOT 
SIGEMT 07* 
SIGFPE 
SIGKILLOS9 
SIGBUS 10° 
SIGSEGV 
SIGSYS 
SIGPIPE13 
SIGALRM 
SIGTERM 
SIGUSAT 
SIGUSR2 
SIGCLD 18 
SIGPWR 


hangup 

02 interrupt 

03* quit 

04* illegal instruction (not reset when caught) 


05" trace trap (not reset when cave) 


06* [OT instruction 
EMT instruction 


- 08" floating point exception 


kill (cannot be caught or ignored) 

bus error 

11* segmentation violation 

12" bad argument to system call 
write on a pipe with no one to read it 
14 alarm clock 

15 software termination signal 
16 user defined signal 1 

17 user defined signal 2 

death of a child (see WARNING below) 
19 power fail (see WARNING below) 


See below for the significance of the asterisk in the above list. 


Func is assigned one of three values: SIG_DFL, SIG_IGN, or a function address. The actions 
prescribed by these values of are as follows: 


terminate process upon receipt of a signal 


Upon receipt of the signal sig, the receiving process is to be terminated with the fol- 
lowing consequences: 


All of the receiving process's open file descriptors will be closed. 








If the parent process of the receiving process is executing a wait, it will be noti- 
fied of the termination of the receiving process and the terminating signal's 
number will be made available to the parent process; see wait(2). 


If the parent process of the receiving process is not executing a wait, the receiv- 


ing process will be transformed into a zombie process (see exit(2) for definition 
of zombie process). 


The parent process ID of each of the receiving process's existing child processes 
and zombie processes will be set to 1. This means the initialization process 
(see intro(2)) inherits each of these processes. 


An accounting record will be written on the accounting file if the system's 
accounting routine is enabled; see acct(2). 
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SIGNAL (2) 


If the receiving process's process ID, tty group ID, and process group ID are 
equal, the signal SIGHUP will be sent to all of the processes that have a process 
group ID equal to the process group ID of the receiving process. 


A “core image” will be made in the current working directory of the receiving 
process if sig is one for which an asterisk appears in the above list and the fol- 
lowing conditions are met: 
The effective user ID and the real user ID of the receiving process are 
equal. 


An ordinary file named core exists and is writable or can be created. If 
the file must be created, it will have the following properties: 


a mode of 0666 modified by the file creation mask (see 
umask (2)) 


a file owner ID that is the same as the effective user ID of the 
receiving process 


a file group ID that is the same as the effective group ID of the 
receiving process 


SIG_IGN - ignore signal 


The signal sig is to be ignored. 
Note: the signal SIGKILL cannot be ignored. 


function address - catch signal 


Upon receipt of the signal sig, the receiving process is to execute the signal-catching 
function pointed to by func. The signal number sig will be passed as the only argu- 
ment to the signal-catching function. 


Upon return from the signal-catching function, the receiving process will resume exe- 
cution at the point it was interrupted and the value of func for the caught signal will 
be set to SIG_DFL unless the signal is SIGILL, SIGTRAP, SIGCLD, or SIGPWR. 


When a signal that is to be caught occurs during a read, a write, an open, or an ioctl 
system call on a slow device (like a terminal; but not a file), during a pause system 
call, or during a wait system call that does not return immediately due to the 
existence of a previously stopped or zombie process, the signal catching function will 
be executed and then the interrupted system call will return a -1 to the calling pro- 
cess with errno set to EINTR. 


Note: the signal SIGKILL cannot be caught. 


A call to signal cancels a pending signal sig except for a pending SIGKILL signal. 
Signal will fail if one or more of the following are true: 

Sig is an illegal signal number, including SIGKILL. [EINVAL] 

Func points to an illegal address. [EFAULT] 


RETURN VALUE 


Upon successful completion, signal returns the previous value of func for the specified signal 
sig. Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 


kill(1), kill(2), pause(2), ptrace(2), wait(2), setjimp(3C). 


WARNING 


Two other signals that behave differently than the signals described above exist in this release 
of the system; they are: 
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SIGCLD 18 death of a child (not reset when caught) 
SIGPWR 19 power fail (not reset when caught) 


There is no guarantee that, in future releases of UNIX, these signals will continue to behave as 
described below; they are included only for compatibility with other versions of UNIX. Their use 
in new programs is strongly discouraged. 


For these signals, func is assigned one of three values: SIG_DFL, SIG_IGN, or a function 
address. The actions prescribed by these values of are as follows: 


SIG_DFL - ignore signal 
The signal is to be ignored. 


SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD, the calling process's child 
processes will not create zombie processes when they terminate; see exit(2). 


function address - catch signal 
If the signal is SIGPWR, the action to be taken is the same as that described above 
for func equal to function address. The same is true if the signal is SIGCLD except, 
that while the process is executing the signal-catching function any received SIGCLD 
signals will be queued and the signal-catching function will be continually reentered 
until the queue is empty. 


The SIGCLD affects two other system calls (wait(2), and exit(2)) in the following ways: 


wait If the func value of SIGCLD is set to SIG_IGN and a wait is executed, the wait will 
block until all of the calling process's child processes terminate; it will then return a 
value of -1 with errno set to ECHILD. 


exit If in the exiting process’s parent process the func value of SIGCLD is set to SIG_IGN, 
the exiting process will not create a zombie process. 


When processing a pipeline, the shell makes the last process in the pipeline the parent of the 
proceeding processes. A process that may be piped into in this manner (and thus become 
the parent of other processes) should take care not to set SIGCLD to be caught. 
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NAME 





stat, fstat - get file status 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 
int stat (path, buf) 
char «path; 
struct stat «buf; 


int fstat (fildes, buf) 
int fildes; 
struct stat «buf; 


DESCRIPTION 
Path points to a path name naming a file. Read, write or execute permission of the named file 
is not required, but all directories listed in the path name leading to the file must be searchable. 
Stat obtains information about the named file. 


Similarly, fstat obtains information about an open file known by the file descriptor fildes, 
obtained from a successful open, creat, dup, fcnt!, or pipe system call. 


Buf is a pointer to a stat structure into which information is placed concerning the file. 


The contents of the structure pointed to by buf include the following members: 
ushort st_mode;  /« File mode; see mknod(2) «/ 


ino_t st_ino; /* Inode number +/ 
dev_t st_dev; /x ID of device containing +/ 

/x a directory entry for this file «/ 
dev_t = st_rdev; /x ID of device «/ 





/* This entry is defined only for +/ 
/* character special or block special files +/ 
short _— st_nlink; /*« Number of links +/ 


ushort _ st_uid; /« User ID of the file’s owner +/ 
ushort _st_gid; /»x Group ID of the file’s group +/ 
off_t st_size; /x File size in bytes «/ 


time_t  st_atime; /x Time of last access +/ 
time_t st_mtime;  /« Time of last data modification +/ 
time_t st_ctime; /x Time of last file status change +/ 
/x Times measured in seconds since +/ 
/« 00:00:00 GMT, Jan. 1, 1970 +/ 


st_atime Time when file data was last accessed. Changed by the following system calls: 
creat(2), mknod(2), pipe(2), utime(2), and read (2). 


st_mtime Time when data was last modified. Changed by the following system calls: creat(2), 
mknod (2), pipe(2), utime(2), and write(2). 


st_ctime Time when file status was last changed. Changed by the following system calls: 
chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), unlink(2), utime(2), and 
write (2). 


Stat will fail if one or more of the following are true: 
A component of the path prefix is not a directory. [ENOTDIR] 
The named file does not exist. [ENOENT] 
Search permission is denied for a component of the path prefix. [EACCES] 
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Buf or path points to an invalid address. [EFAULT] 

Fstat will fail if one or more of the following are true: 
Fildes is not a valid open file descriptor. [EBADF] 
Buf points to an invalid address. [EFAULT] 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 


errno is set to indicate the error. 


SEE ALSO . 
chmod(2), chown(2), creat(2), link(2), mknod(2), time(2), unlink(2). 
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NAME 

stime - set time 
SYNOPSIS 

int stime (tp) 

long stp; 
DESCRIPTION 


Stime sets the system's idea of the time and date. Tp points to the value of time as measured 
in seconds from 00:00:00 GMT January 1, 1970. 


Stime will fail if the effective user ID of the calling process is not super-user. [EPERM] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
time(2). 
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NAME 





sync - update super-block 
SYNOPSIS 
sync ( ) 
DESCRIPTION 
Sync causes all information in memory that should be on disk to be written out. This includes 
modified super blocks, modified i-nodes, and delayed block I/O. 


It should be used by programs which examine a file system, for example fsck, df, etc. It is 
mandatory before a boot. 
The writing, although scheduled, is not necessarily complete upon return from sync. 


SEE ALSO 
sync(1M). 
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NAME 
syscall.h - numeric id of system call 


SYNOPSIS 
/usr/include/syscall.h 


DESCRIPTION 

The Plexus UNIX operating system recognizes the following system calls. They are used in the 

28000 sc xx assembly instruction. 
#defineINDIR O 
#defineEXIT 1 
#defineFORK 2 
#defineREAD 3 
#defineWRITE 4 
#defineOPEN 5 
#defineCLOSE 6 
#defineWAIT 7 
#defineCREAT 8 
#defineLINK 9 
#defineUNLINK 10 
#defineEXEC 11 
#defineCHDIR 12 
#defineTIME 13 





#-define MKNOD 14 
#defineCHMOD 15 
#defineCHOWN 16 
#defineBREAK 17 





#defineSTAT 18 
#defineLSEEK 19 


#defineGETPID 20 
#define MOUNT 21 
#defineUMOUNT 22 
#defineSETUID 23 
#defineGETUID 24 
#defineSTIME 25 
#definePTRACE 26 
#defineALARM 27 
#defineFSTAT 28 
#definePAUSE 29 


#defineUTIME 30 

#defineSTTY 31 

#defineGTTY 32 

#defineACCESS 33 

#defineNICE 34 

i* 35 Version 7: FTIME */ 
#defineSYNC 36 

#defineKILL 37 

#defineCSW 38 /* Not in Weco R-II! */ 
#defineSETPGRP 39 

#defineDUP 41 

#definePIPE 42 

#defineTIMES 43 





#definePROFIL 44 
#defineLOCKING 45 /* Not in Weco R-III */ 
#defineSETGID 46 : 
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#defineGETGID 47 a 
#defineSIGNAL 48 Mes 
#defineACCT 51 

/* 52 Version 7: PHYS rh 

/* 53 Version 7: LOCK af 


#definelOCTL 54 

#defineREBOOT 55 /* Not in Weco R-II! */ 
#define FONTL56 /* Version 7: MPX */ 

#define PWBSYS 57 /* UNAME and USTAT sys calls. V7: undefined */ 
#defineEXECE 59 | 

#define UMASK60 

#defineCHROOT 61 

#define UGROW 62 /* R-Ul: FONTL */ 
#define ULIMIT63 /* Version 7: undefined */ 
#define RMOUNT 64 3 /* NOS only */ 

#define RUMOUNT 65 = /* NOS only */ 
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NAME 
time - get time 
SYNOPSIS 
long time ((long «) 0) 
long time (tloc) 
long stloc; 


DESCRIPTION 
Time returns the value of time in seconds since 00:00:00 GMT, January 1, 1970. 


If tloc (taken as an integer) is non-zero, the return value is also stored in the location to which 
tloc points. 


Time will fail if tloc points to an illegal address. (EFAULT) 


RETURN VALUE 
Upon successful completion, time returns the value of time. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
stime(2). 
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NAME 





times - get process and child process times 


SYNOPSIS 
long times (buffer) 
struct tbuffer «buffer; 
struct tbuffer { 
long utime; 
long __stime; 
long cutime; 
long cstime; 
} 
DESCRIPTION 
Times fills the structure pointed to by buffer with time-accounting information. This information 
comes from the calling process and each of its terminated child processes for which it has exe- 
cuted a wait. 


All times are in 50ths of a second for the Z8000, 64ths of a second for the MC68000. 

Utime is the CPU time used while executing instructions in the user space of the calling process. 
Stime is the CPU time used by the system on behalf of the calling process. 

Cutime is the sum of the utimes and cutimes of the child processes. 

Cstime is the sum of the stimes and cstimes of the child processes. 

Times will fail if buffer points to an illegal address. [EFAULT] 


RETURN VALUE 


Upon successful completion, times returns the elapsed real time -- in 50ths of a second for the 
Z8000, 64ths of a second for the MC68000 -- since an arbitrary point in the past (e.g., system 
start-up time). This point does not change from one invocation of times to another. If times 
fails, a -1 is returned and errno is set to indicate the error. 

SEE ALSO 
exec(2), fork(2), time(2), wait(2). 
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NAME 
ugrow - change system stack limit 
SYNOPSIS 
ugrow(addr); 
char ‘addr; 
char *_endstk 
DESCRIPTION 
Ugrow sets the lower limit on the user’s stack area. Pushing the stack to an address lower than 
this limit could cause a memory fault or overwrite data. 


Addr should be a multiple of the system page size (0x800), since the limit is modified in page- 
size increments. Otherwise, it is rounded down to the next page boundary. 
Ugrow is automatically called when necessary by the library routine csav, which is invoked upon 
procedure entry. A global variable _endstk contains the last value of addr passed to ugrow; 
_endstk is also used by other library routines. 

RETURN VALUE 


Upon successful completion a value of 0 is returned. Otherwise, -1 is returned and errno is set 
to indicate the error. 
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NAME 
ulimit - get and set user limits 


SYNOPSIS 
long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 
DESCRIPTION 
This function provides for control over process limits. The cmd values available are: 


1 Get the process's file size limit. The limit is in units of 1024-byte blocks and is inherited 
by child processes. Files of any size can be read. 


2 ‘Set the process's file size limit to the value of newlimit. Any process may decrease this 
limit, but only a process with an effective user ID.of super-user may increase the limit. 
Ulimit will fail and the limit will be unchanged if a process with an effective user ID other 
than super-user attempts to increase its file size limit. [EPERM] 


3 Get the maximum possible break value. See brk(2). 


RETURN VALUE 
Upon successful completion, a non-negative value is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


SEE ALSO 
brk(2), write(2). 
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NAME 
umask - set and get file creation mask 


SYNOPSIS 
int umask (cmask) 
int cmask; 


DESCRIPTION 
Umask sets the process's file mode creation mask to cmask and returns the previous value of 
the mask. Only the low-order 9 bits of cmask and the file mode creation mask are used. 


RETURN VALUE 
The previous value of the file mode creation mask is returned. 


SEE ALSO 
mkdir(1), mknod(1M), sh(1), chmod(2), creat(2), mknod(2), open(2). 


Page 1 March 9, 1984 


~ UMOUNT(2) UMOUNT (2) 


NAME 
umount - unmount a file system 


SYNOPSIS 
int umount (spec) 
char «spec; 


DESCRIPTION 
Umount requests that a previously mounted file system contained on the block special device 
identified by spec be unmounted. Spec is a pointer to a path name. After unmounting the file 
system, the directory upon which the file system was mounted reverts to its ordinary interpreta- 
tion. 


Umount may be invoked only by the super-user. 
Umount will fail if one or more of the following are true: 
The process's effective user ID is not super-user. [EPERM] 
Spec does not exist. [ENXIO] 
Spec is not a block special device. [ENOTBLK] 
Spec is not mounted. [EINVAL] 
A file on spec is busy. [EBUSY] 
Spec points outside the process's allocated address space. [EFAULT] 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
mount(1M), mount(2). 
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NAME 
uname - get name of current UNIX system 
SYNOPSIS 
#include <sys/utsname.h> 
int uname (name) 
struct utsname «name; 
DESCRIPTION 
Uname stores information identifying the current UNIX system in the structure pointed to by 
name. 
Uname uses the structure defined in <sys/utsname.h >: 
struct utsname { 
char sysname{[9}; 
char nodename{9]; 


char _ release{9]; 
char — version{9]; 
extern struct utsname utsname; 
Uname returns a null-terminated character string naming the current UNIX system in the charac- 
ter array sysname. Similarly, nodename contains the name that the system is known by on a 
communications network. Release and version further identify the operating system. 
Uname will fail if name points to an invalid address. [EFAULT] 


RETURN VALUE 
Upon successful completion, a non-negative value is returned. Otherwise, -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
uname(1). 


Page 1 March 9, 1984 


UNLINK(2) | UNLINK(2) 


NAME 





unlink - remove directory entry 


SYNOPSIS 
int unlink (path) 
char «path; 


DESCRIPTION 
Unlink removes the directory entry named by the path name pointed to be path. 


The named file is unlinked unless one or more of the following are true: 
A component of the path prefix is not a directory. [ENOTDIR] 
The named file does not exist. [ENOENT] 
Search permission is denied for a component of the path prefix. [EACCES] 
Write permission is denied on the directory containing the link to be removed. [EACCES] 


The named file is a directory and the effective user ID of the process is not super-user. 
[EPERM] 


The entry to be unlinked is the mount point for a mounted file system. [EBUSY] 


The entry to be unlinked is the last link to a pure procedure (shared text) file that is 
being executed. [ETXTBSY] | 


The directory entry to be unlinked is part of a read-only file system. [EROFS] 
Path points outside the process's allocated address space. [EFAULT] 


When all links to a file have been removed and no process has the file open, the space occu- 
pied by the file is freed and the file ceases to exist. If one or more processes have the file open 
when the last link is removed, the removal is postponed until all references to the file have been a 
closed. - 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 
rm(1), close(2), link(2), open(2). 
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NAME 





ustat - get file system statistics 


SYNOPSIS 
#include <sys/types.h> 
#include <ustat.h> 


int. ustat (dev, buf) 
int dev; 
struct ustat «buf; 


DESCRIPTION 
Ustat returns information about a mounted file system. Dev is a device number identifying a 
device containing a mounted file system. Buf is a pointer to a ustat structure that includes to 
following elements: 


daddr_t f_tfree; /x Total free blocks «/ 

ino_t  f_tinode; /« Number of free inodes +/ 
char f_fname(6]; /x Filsys name +/ 

char f_fpack([6]; /x Filsys pack name +/ 


Ustat will fail if one or more of the following are true: 
Dev is not the device number of a device containing a mounted file system. [EINVAL] 
Buf points outside the process's allocated address space. [EFAULT] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
stat(2), fs(5). 











UTIME(2) | UTIME(2) 


NAME 
utime - set file access and modification times 
SYNOPSIS 
#include <sys/types.h> 
int utime (path, times) 
char spath; 
- gtruct utimbuf <«times; 


DESCRIPTION 


Path points to a path name naming a file. Utime sets the access and modification times of the 
named file. 


If times is NULL, the access and modification times of the file are set to the current time. A pro- 
cess must be the owner of the file or have write permission to use utime in this manner. 


If times is not NULL, times is interpreted as a pointer to a utimbuf structure and the access and 
- modification times are set to the values contained in the designated structure. Only the owner 
of the file or the super-user may use ufime this way. 


The times in the following structure are measured in seconds since 00:00:00 GMT, Jan. 1, 1970. 


struct utimbuf { 
time_t actime; /* access time «/ 
time_t modtime; /« modification time «/ 


}; | 
Utime will fail if one or more of the following are true: 
The named file does not exist. [ENOENT] 
A component of the path prefix is not a directory. [ENOTDIR] 
Search permission is denied by a component of the path prefix. [EACCES] 


The effective user ID is not super-user and not the owner of the file and times is not 
NULL. [EPERM] 


The effective user ID is not super-user and not the owner of the file and times is NULL 
and write access is denied. [EACCES] 


The file system containing the file is mounted read-only. [EROFS] 
Times is not NULL and points outside the process's allocated address space. [EFAULT] 
Path points outside the process's allocated address space. [EFAULT] 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
stat(2). 
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NAME 


wait - wait for child process to stop or terminate 


SYNOPSIS 


int wait (stat_loc) 
int «stat_loc; 


int wait ((int «)0) 


DESCRIPTION 


Wait suspends the calling process until it receives a signal that is to be caught (see signal(2)), 
or until any one of the calling process's child processes stops in a trace mode (see ptrace(2)) or 
terminates. If a child process stopped or terminated prior to the call on wait, return is immedi- 
ate. 


lf stat_loc (taken as an integer) is non-zero, 16 bits of information called status are stored in the 
low order 16 bits of the location pointed to by stat_loc. Status can be used to differentiate 
between stopped and terminated child processes and if the child process terminated, status 
identifies the cause of termination and pass useful information to the parent. This is accom- 
plished in the following manner: 


If the child process stopped, the high order 8 bits of status will be zero and the low order 
8 bits will be set equal to 0177. 


If the child process terminated due to an exit call, the low order 8 bits of status will be 
zero and the high order 8 bits will contain the low order 8 bits of the argument that the 
child process passed to exit; see exit(2). 


If the child process terminated due to a signal, the high order 8 bits of status will be zero 
and the low order 8 bits will contain the number of the signal that caused the termina- 
tion. In addition, if the low order seventh bit (i.e., bit 200) is set, a “core image” will have 
been produced; see signal(2). 


lf a parent process terminates without waiting for its child processes to terminate, the parent 
process !D of each child process is set to 1. This means the initialization process inherits the 
child processes; see intro(2). 


Wait will fail and return immediately if one or more of the following are true: 
The calling process has no existing unwaited-for child processes. [ECHILD] 
Stat_loc points to an illegal address. [EFAULT] 


RETURN VALUE 


If wait returns due to the receipt of a signal, a value of -1 is returned to the calling process and 
errno is set to EINTR. If wait returns due to a stopped or terminated child process, the process 
ID of the child is returned to the calling process. Otherwise, a value of -1 is returned and errno 
is set to indicate the error. 


SEE ALSO 


exec(2), exit(2), fork(2), pause(2), signal(2). 


WARNING 
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See WARNING in signal(2). 
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NAME 


write - write on a file 


SYNOPSIS 


int write (fildes, buf, nbyte) 
int fildes; 

char «buf; 

unsigned nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, dup, fentl, or pipe system call. 


Write attempts to write nbyte bytes from the buffer pointed to by buf to the file associated with 
the fildes. 


On devices capable of seeking, the actual writing of data proceeds from the position in the file 
indicated by the file pointer. Upon return from write, the file pointer is incremented by the 
number of bytes actually written. 


On devices incapable of seeking, writing always takes place starting at the current position. The 
value of a file pointer associated with such a device is undefined. 


If the O_APPEND flag of the file status flags is set, the file pointer will be set to the end of the file 
prior to each write. 


Write will fail and the file pointer will remain unchanged if one or more of the following are true: 
Fildes is not a valid file descriptor open for writing. [EBADF] 


An attempt is made to write to a pipe that is not open for reading by any process. 
[EPIPE and SIGPIPE signal] 


An attempt was made to write a file that exceeds the process's file size limit or the max- 
imum file size. See ulimit(2). [EFBIG] 


Buf points outside the process's allocated address space. (EFAULT] 


lf a write requests that more bytes be written than there is room for (e.g., the ulimit (see 
ulimit(2)) or the physical end of a medium), only as many bytes as there is room for will be writ- 
ten. For example, suppose there is space for 20 bytes more in a file before reaching a limit. A 
write of 512 bytes will return 20. The next write of a non-zero number of bytes will give a 
failure return (except as noted below). 


If the file being written is a pipe (or FIFO), no partial writes will be permitted. Thus, the write will 
fail if a write of nbyte bytes would exceed a limit. 


If the file being written is a pipe (or FIFO) and the O_NDELAY flag of the file flag word is set, then 
write to a full pipe (or FIFO) will return a count of 0. Otherwise ee NDELAY clear), writes to a full 
pipe (or FIFO) will block until space becomes available. 


RETURN VALUE 


Upon successful completion the number of bytes actually written is returned. Otherwise, -1 is 
returned and errno is set to indicate the error. 


SEE ALSO 


Page 1 


creat(2), dup(2), Ilseek(2), open(2), pipe(2), ulimit(2). 


\ 
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NAME 
intro - introduction to subroutines and libraries 


SYNOPSIS 
#include <stdio.h> 


f#include <math.h> 


DESCRIPTION 
This section describes functions found in various libraries, other than those functions that 
directly invoke UNIX system primitives, which are described in Section 2 of this volume. Certain 
major collections are identified by a letter after the section number: 


(3C) These functions, together with those of Section 2 and those marked (3S), constitute 
library fibc, which is automatically loaded by the C compiler, cc(1). The link editor /d(1) 
searches this library under the -Ic option. Declarations for some of these functions may 
be obtained from #include files indicated on the appropriate pages. 

(3M) These functions constitute the math library, liom. They are automatically loaded as 
needed by the FORTRAN compiler f77(1). The link editor searches this library under the 
-im option. Declarations for these functions may be obtained from the #include file 
<math.h>. 

(3S) These functions constitute the “standard VO package” (see stdio(3S)). These functions 

are in the library libc, already mentioned. Declarations for these functions may be 
obtained from the #include file <stdio.h>. 

(3X) Various specialized libraries. The files in which these libraries are found are given on the 
appropriate pages. 


The descriptions of some functions refer to NULL. This is the value that is obtained by casting 0 
into a character pointer. The C language guarantees that this value will not match that of any 
legitimate pointer, so many functions that return pointers return it, for example, to indicate an 
error. NULL is defined in <stdio.h> as 0; the user can include his own definition if he is not 
using <stdio.h>. 


FILES 


/lib/libc.a 
{ib/liom.a 


NOTES 
Plexus does not provide fptrap(3X), which is specific to non-Plexus hardware and not generally 
supported in SYSTEM Ili. Plexus adds curses and termlib. 
SEE ALSO : 
ar(1), cc(1), 77(1), 1d(1), nm(1), intro(2), stdio(3S). 
DIAGNOSTICS 
Functions in the math library (83M) may return conventional values when the function is unde- 


fined for the given arguments or when the value is not representable. In these cases, the exter- 
nal variable errno (see intro(2)) is set to the value EDOM or ERANGE. 
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NAME 
a64l, |64a - convert between long and base-64 ASCII 

SYNOPSIS 
long a64l (s) 
char +s; 
char «164a (I) 
long |; 

DESCRIPTION 
These routines are used to maintain numbers stored in base-64 ASCII. This is a notation by 
which long integers can be represented by up to six characters; each character represents a 
“digit” in a radix-64 notation. 
The characters used to represent “digits” are . for 0, / for 1, 0 through 9 for 2-11, A through Z 
for 12-37, and a through z for 38-63. 
A64/ takes a pointer to a null-terminated base-64 representation and returns a corresponding 
long value. L64a takes a long argument and returns a pointer to the corresponding base-64 
representation. 

BUGS 


The value returned by /64a is a pointer into a static buffer, the contents of which are overwritten 
by each call. 
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NAME 





abort - generate an IOT fault 
SYNOPSIS 

abort ( ) 
DESCRIPTION 


Abort causes an IOT signal to be sent to the process. This usually results in termination with a 
core dump. 


It is possible for abort to return control if SIGIOT is caught or ignored. 
SEE ALSO 

adb(1), exit(2), signal(2). 
DIAGNOSTICS 

Usually “abort - core dumped” from the shell. 
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NAME 
abs - integer absolute value 


SYNOPSIS 
int abs (i) 
int i; 
DESCRIPTION 
Abs returns the absolute value of its integer operand. 


SEE ALSO 
fabs(3M). 


BUGS 7 
You get what the hardware gives on the largest negative integer. 
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NAME 
assert - program verification 


SYNOPSIS 
#include <assert.h> 


assert (expression); 


DESCRIPTION 
This macro is useful for putting diagnostics into programs. When it is executed, if expression is 
false, it prints “Assertion failed: file xyz, line nnn” on the standard error file and exits. Xyz is the 
source file and nnn the source line number of the assert statement. Compiling with the prepro- 
cessor option -DNDEBUG (see cc (1)) will cause assert to be ignored. 
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NAME 





atof, atoi, atol - convert ASCII to numbers 


SYNOPSIS 
double atof (nptr) 
char snptr; 
int atoi (nptr) 
char «nptr; 
long atol (nptr) 

| char «nptr; 
DESCRIPTION 


These functions convert a string ‘pointed to by nptr to floating, integer, and long integer 
representation respectively. The first unrecognized character ends the string. 


Atof recognizes an optional string of tabs and spaces, then an optional sign, then a string of 
digits optionally containing a decimal point, then an optional e or E followed by an optionally 
signed integer. 
Atoi and ato! recognize an optional string of tabs and spaces, then an optional sign, then a 
string of digits. 

SEE ALSO 
scanf(3S). 


BUGS 
There are no provisions for overflow. 
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NAME 





jO, j1, jn, yO, y1, yn - bessel functions 
SYNOPSIS 

#include <math.h> 

double jO (x) 

double x; 

double ji (x) 

double x; 

double jn (n, x); 

double x; 

double yO (x) 

double x; 

double y1 (x) 

double x; 

double yn (n, x) 

int n; 

double x; 
DESCRIPTION 


These functions calculate Bessel functions of the first and second kinds for real arguments and 
integer orders. 


DIAGNOSTICS 
Negative arguments cause yO, y7, and yn to return a huge negative value. 
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NAME 
bsearch - binary search 


SYNOPSIS 
char «bsearch (key, base, nel, width, compar) 
char skey; 
char sbase; 
int nel, width; 
int (scompar)(); 


DESCRIPTION 
Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm B. It returns a 
pointer into a table indicating the location at which a datum may be found. The table must be 
previously sorted in increasing order. The first argument is a pointer to the datum to be located 
in the table. The second argument is a pointer to the base of the table. The third is the number 
of elements in the table. The fourth is the width of an element in bytes. The last is the name of 
the comparison routine. It is called with two arguments which are pointers to the elements 
being compared. The routine must return an integer less than, equal to, or greater than 0 
according as the first argument is to be considered less than, equal to, or greater than the 
second. 


DIAGNOSTICS 
Zero is returned if the key can not be found in the table. 


SEE ALSO 
lsearch(3C), qsort(3C). 
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NAME 
toupper, tolower, toascii - character translation 
SYNOPSIS 
#include <ctype.h> 
int toupper (c) 
int c; 
int tolower (c) 
int c; 
int _toupper (c) 
int Cc; 
int _tolower (c) 
int c; 
int toascii (c) 
int c; 
DESCRIPTION 


Toupper and tolower have as domain the range of getc: the integers from -1 through 255. If 
the argument of foupper represents a lower-case letter, the result is the corresponding upper- 
case letter. If the argument of tofower represents an upper-case letter, the result is the 
corresponding lower-case letter. All other arguments in the domain are returned unchanged. 


_toupper and _tolower are macros that accomplish the same thing as toupper and tolower but 
have restricted domains and are faster. _toupper requires a lower-case letter as its argument; 
its result is the corresponding upper-case letter. _folower requires an upper-case letter as its 
argument; its result is the corresponding lower-case letter. Arguments outside the domain 
cause garbage results. 


Toascii yields its argument with all bits turned off that are not part of a standard ASCII character: 
it is intended for compatibility with other systems. 


SEE ALSO 
ctype(3C). 
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NAME 
crypt, setkey, encrypt - DES encryption 

SYNOPSIS 
char scrypt (key, salt) 
char skey, ssalt; 
setkey (key) 
char skey; 
encrypt (block, edflag) 
char «block; 
int edflag; 

DESCRIPTION 
Crypt is the password encryption routine. It is based on the NBS Data Encryption Standard 
(DES), with variations intended (among other things) to frustrate use of hardware implementa- 
tions of the DES for key search. 
The first argument to crypt is a user's typed password. The second is a 2-character string 
chosen from the set [a-zA-Z0-9./]; this salt string is used to perturb the DES algorithm in one of 
4096 different ways, after which the password is used as the key to encrypt repeatedly a con- 
stant string. The returned value points to the encrypted password, in the same alphabet as the 
salt. The first two characters are the salt itself. 
The setkey and encrypt entries provide (rather primitive) access to the actual DES algorithm. 
The argument of setkey is a character array of length 64 containing only the characters with 
numerical value 0 and 1. If this string is divided into groups of 8, the low-order bit in each 
group is ignored, leading to a 56-bit key which is set into the machine. 
The argument to the encrypt entry is likewise a character array of length 64 containing O's and 
1's. The argument array is modified in place to a similar array representing the bits of the argu- 
ment after having been subjected to the DES algorithm using the key set by setkey. If edflag is 
0, the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 
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login(1), passwd(1), getpass(3C), passwd(5). 
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BUGS 
The return value points to static data that are overwritten by each call. 


Passwords encrypted under V7 use the German Enigma method, which is incompatible with 
DES. 
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NAME 
ctermid - generate file name for terminal 


SYNOPSIS 
 #include <stdio.h> 


char sctermid(s) 
char <s; 


DESCRIPTION 
Ctermid generates a string that refers to the controlling terminal for the current process when 
used as a file name. 


If (int)s is zero, the string is stored in an internal static area, the contents of which are overwrit- 
ten at the next call to ctermid, and the address of which is returned. If (int)s is non-zero, then s 
is assumed to point to a character array of at least L_ctermid elements; the string is placed in 
this array and the value of s is returned. The manifest constant L_ctermid is defined in 
<stdio.h>. 


NOTES 
The difference between ctermid and ttyname(3C) is that ttyname must be handed a file descrip- 
tor and returns the actual name of the terminal associated with that file descriptor, while ctermid 
returns a magic string (/dev/tty) that will refer to the terminal if used as a file name. Thus 
ttyname is useless unless the process already has at least one file open to a terminal. 


SEE ALSO 
ttyname(3C). 
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NAME 


ctime, localtime, gmtime, asctime, tzset - convert date and time to ASCII 


SYNOPSIS 


#include <time.h> 


char cbuf[26]; 
int dmsize[12]; 
long timezone; 
char stznamef]; 
int daylight; 
struct { 

int daylb; 

int dayle; 
} daytabj]; 
char «ctime (clock) 
long «clock; 


struct tm slocaltime (clock) 
long «clock; 


struct tm «gmtime (clock) 
long «clock; 


char sasctime (tm) 
struct tm «tm; 


tzset ( ) 


DESCRIPTION 


Ctime converts a time pointed to by clock such as returned by time(2) into ASCII and returns a 
pointer to a 26-character string in the following form. All the fields have constant width. 


Sun Sep 16 01:03:52 1973\n\0 


Localtime and gmtime return pointers to structures containing the broken-down time. Locaftime 
corrects for the time zone and possible daylight savings time; gmtime converts directly to GMT, 
which is the time the UNIX system uses. Asctime converts a broken-down time to ASCII and 


- returns a pointer to a 26-character string. 
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The structure declaration from the include file is: 
struct tm{  /* see ctime(3) */ 


int tm_sec; 
int tm_min; 
int tm_hour; 
int tm_mday; 
int tm_mon; 
int tm_year; 
int tm_wday; 
int tm_yday; 
int tm_isdst; 


}: 
These quantities give the time on a 24-hour clock, day of month (1-31), month of year (0-1 1), 


day of week (Sunday = 0), year - 1900, day of year (0-365), and a flag that is non-zero if day- 
light saving time is in effect. | 


The external long variable timezone contains the difference, in seconds, between GMT and local 


standard time (in EST, timezone is 5+*60+60); the external variable daylight is non-zero if and 
only if the standard U.S.A. Daylight Savings Time conversion should be applied. The program 
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_knows about the peculiarities of this conversion in 1974 and 1975; if necessary, a table for these 
years can be extended. 


If an environment variable named TZ is present, asctime uses the contents of the variable to 
override the default time zone. The value of TZ must be a three-letter time zone name, followed 
by a number representing the difference between local time and Greenwich time in hours, fol- 
lowed by an optional three-letter name for a daylight time zone. For example, the setting for 
New Jersey would be EST5EDT. The effects of setting TZ are thus to change the values of the 
external variables timezone and daylight; in addition, the time zone names contained in the 
external variable 


char stzname[2] = {"EST*, "EDT"}; 


are set from the environment variable. The function tzset sets the external variables from TZ; it 
is called by asctime and may also be called explicitly by the user. 


SEE ALSO 


BUGS 


time(2), getenv(3C), environ(7). 


The return values point to static data whose content is overwritten by each call. 
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NAME 


isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, 


CTYPE(3C) 


isascii - character classification 


SYNOPSIS 
#include <ctype.h> 


int isalpha (c) 


int c; 


DESCRIPTION 


These macros classify ASCil-coded integer values by table lookup. Each is a predicate return- 
ing nonzero for true, zero for false. /sascii is defined on all integer values; the rest are defined 


only where isascii is true and on the single non-ASCll value EOF (see stdio(3S)). 


isalpha 
isupper 
islower 
isdigit 
isxdigit 
isalnum 
isspace 
ispunct 
isprint 
isgraph 
iscntrl 
isascii 


SEE ALSO 
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ascii(7). 


c is a letter 

c is an upper case letter 

c is a lower case letter 

c is a digit [0-9] 

c is a hexidecimal digit [0-9], [A-F] or [a-f] 

c is an alphanumeric 

c is a space, tab, carriage return, new-line, vertical tab, or form-feed 
c is a punctuation character (neither control nor alphanumeric) 

c is a printing character, code 040 (space) through 0176 (tilde) 

c is a printing character, like isprint except false for space 

c is a delete character (0177) or ordinary control character (less than 040). 
c is an ASCll character, code less than 0200 
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NAME 


(Plexus) CURSES(3C) 


curses - screen functions with "optimal" cursor motion 


SYNOPSIS 


DESCRIPTION 


cc [ flags ] files -Icurses -itermlib [ libraries ] 


These routines give the user a method of updating screens with reasonable optimization. They 
keep an image of the current screen, and the user sets up an image of a new one. Then the 
refresh() tells the routines to make the current screen look like the new one. In order to initialize 
the routines, the routine inifscr() must be called before any of the other routines that deal with 


windows and screens are used. 
SEE ALSO 


termcap (5), stty (2), setenv (3), setenv (3). 


FUNCTIONS 
addch(ch) 
addstr(str) 
box(win,vert,hor) 
cbreak() 
clear() 
clearok(scr,booif) 
cirtobot() 
cirtoeol() 
delwin(win) 
echo() 
erase() 
getch() 
getstr(str) 
gettmode() 
getyx(win,y,x) 
inch() 
initser() 
leaveok(win,booif) 
longname(termbuf,name) 
move(y,x) 
mvcur(lasty, lastx, newy,newx) 
newwin(lines,cols,begin_y,begin_x) 
ni() | 
nocbreak() 
noecho() 
noni() 
noraw() 
overlay(win1 ,win2) 
overwrite(win1 ,win2) 
printw(fmt,arg1 ,arg2,...) 
raw() 
refresh() 
restty() 
savetty() 
scanw(fmt,arg1 ,arg2,...) 
scroll(win) . 
scrollok(win,boolf) 
setterm(name) 
unctri(ch) 
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add a character to stdscr 
add a string to stdscr 

draw a box around a window 
set cbreak mode 

clear stdscr 

set clear flag for scr 

clear to bottom on sitdscr 
clear to end of line on stdscr 
delete win 

set echo mode 

erase stdscr 

get a char through stdscr 
get a string through stdscr 
get tty modes 

get (y,x) co-ordinates 

get char at current (y,x) co-ordinates 


initialize screens 


set leave flag for win 

get long name from termbuf 
move to (y,x) on stdscr 
actually move cursor 

create a new window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 
unser raw mode 

overlay wini on win2 
overwrite win1 on top of win2 
printf on stdscr 

set raw mode 

make current screen look like stdscr 
reset tty flags to stored value 
stored current tty flags 

scanf from stdscr 

scroll win one line 

set scroll flag 

set term variables for name 
printable version of ch 
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waddch(win,ch) add char to win 

waddstr(win,str) add string to win 

wclear(win) clear win 

wcirtobot(win) clear to bottom of win 
weirtoeol(win) clear to end of line on win 
werase(win) erase win 

wgetch(win) get a char through win 
woetstr(win,str) get a string through win 
winch(win) get char at current (y,x) from win 
wmove(win,y,X) set current (y,x) co-ordinates on win 
wprintw(win,fmt,arg1 ,arg2,...) printf on win 

wrefresh(win) make screen look like win 
wscanw(win,fmt,arg1 ,arg2,...) scanf through win 
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NAME 





cuserid - character login name of the user 


SYNOPSIS 
#include <stdio.h> 


char scuserid (s) 
char <s; 


DESCRIPTION 
Cuserid generates a character representation of the login name of the owner of the current pro- 
cess. If (int)s is zero, this representation is generated in an internal static area, the address of 
which is returned. If (int)s is non-zero, s is assumed to point to an array of at least L_cuserid 
characters; the representation is left in this array. The manifest constant L_cuserid is defined 
in <stdio.h>. 


DIAGNOSTICS 
if the login name cannot be found, cuserid returns NULL; if s is non-zero in this case, \O will be 
placed at ss. 


SEE ALSO 
getlogin(3C), getpwuid(3C). 


BUGS 
Cuserid uses getpwnam(3C); thus the results of a user's call to the latter will be obliterated by a 
subsequent call to the former. 
The name cuserid is rather a misnomer. 
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NAME 





ecvt, fcvt - output conversion 


SYNOPSIS 
char secvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, «sign; 


char sfcvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, «sign; 


char <«gcvt (value, ndigit, buf) 
double value; 
char «buf; 


DESCRIPTION 
Ecvt converts the value to a null-terminated string of ndigit ASCII digits and returns a pointer 
thereto. The position of the decimal point relative to the beginning of the string is stored 
indirectly through decpt (negative means to the left of the returned digits). If the sign of the 
result is negative, the word pointed to by sign is non-zero, otherwise it is zero. The low-order 
digit is rounded. 


Fcvt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format out- 
put of the number of digits specified by «_ndigits. 


Gcvt converts the value to a null-terminated ASCII string in buf and returns a pointer to buf. It 
attempts to produce ndigit significant digits in Fortran F format if possible, otherwise E format, 
ready for printing. Trailing zeros may be suppressed. 


SEE ALSO 
printf(3S). 





BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
end, etext, edata - last locations in program 

SYNOPSIS 
extern end; 
extern etext; 
extern edata; 

DESCRIPTION 
These names refer neither to routines nor to locations with interesting contents. The address of 
etext is the first address above the program text, edata above the initialized data region, and 
end above the uninitialized data region. 
When execution begins, the program break coincides with end, but the program break may be 
reset by the routines of brk(2), malioc(3C), standard input/output (sfdio(3S)), the profile (-p) 
option of cc(1), and so on. Thus, the current value of the program break should be determined 
by “sbrk(0)” (see brk(2)). 
These symbols are accessible from assembly language if it is remembered that they should be 
prefixed by _. 

SEE ALSO 


brk(2), malloc(3C). 
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EXP(3M) 


NAME 


exp, log, pow, sqrt - exponential, logarithm, power, square root functions 


SYNOPSIS 


#include <math.h> 


double exp (x) 
double x; 

double log (x) 
double x; 

double pow (x, y) 
double x, y; 


double sqrt (x) 
double x; : 


DESCRIPTION 


Exp returns the exponential function of x. 
Log returns the natural logarithm of x. 
Pow returns x’. 

Sqrt returns the square root of x. 


SEE ALSO 


intro(2), hypot(3M), sinh(3M). 


DIAGNOSTICS 
Exp and pow return a huge value when the correct value would overflow. A truly outrageous 
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argument may also result in errno being set to ERANGE. 


EXP(3M) 


Log returns a huge negative value and sets errno to EDOM when x is non-positive. 
Pow returns a huge negative value and sets errno to EDOM when x is non-positive and y is not 


an integer, or when x and y are both zero. 
Sqrt returns 0 and sets errno to EDOM when x is negative. 
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NAME 
fclose, fflush - close or flush a stream 


SYNOPSIS 
#include <stdio.h> 


int fclose (stream) 
FILE «stream; 


int fflush (stream) 
FILE «stream; 


DESCRIPTION 
Fclose causes any buffers for the named stream to be emptied, and the file to be closed. 
Buffers allocated by the standard input/output system are freed. 


Fclose is performed automatically upon calling exit(2). 


Fflush causes any buffered data for the named output sfream to be written to that file. The 
stream remains open. 


These functions return O for success, and EOF if any errors were detected. 


SEE ALSO 
close(2), fopen(3S), setbuf(3S). 
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NAME 


ferror, feof, clearerr, fileno - stream status inquiries 


SYNOPSIS 


#include <stdio.h> 
int feof (stream) 
FILE «stream; 

int ferror (stream) 
FILE zstream 
clearerr (stream) 
FILE «stream 
fileno(stream) 

FILE +stream; 


DESCRIPTION 


Feof returns non-zero when end of file is read on the named input stream, otherwise zero. 


Ferror returns non-zero when error has occurred reading or writing the named stream, other- 
wise zero. Unless cleared by clearerr, the error indication lasts until the stream is closed. 


Clearerr resets the error indication on the named stream. 
Fileno returns the integer file descriptor associated with the stream, see open (2). 
Feof, ferror, and fileno are implemented as macros; they cannot be re-declared. 


SEE ALSO 
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open(2), fopen(3S). 
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NAME | 
floor, fabs, ceil, fmod - absolute value, floor, ceiling, remainder functions 


SYNOPSIS 
#include <math.h> 


double floor (x) 
double x; 


double ceil (x) 
double x; 


double fmod (x, y) 
double x, y; 


double fabs (x) 
double x; 


DESCRIPTION 
Fabs returns |x|. 


Floor returns the largest integer (as a double precision number) not greater than x. 
Ceil returns the smallest integer not less than x. 


Fmod returns the number f such that x = iy +- f, for some integer /, and 
0 < fey. 


SEE ALSO 
abs(3C). 
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NAME 





fopen, freopen, fdopen - open a stream 


SYNOPSIS 
#include <stdio.h> 


FILE «fopen (file-name, type) 
char sfile-name, «type; 


FILE sfreopen (file-name, type, stream) 
char sfile-name, «type; 
FILE «stream; 


FILE «fdopen (fildes, type) 
int fildes; 
char stype; 
DESCRIPTION 
Fopen opens the file named by file-name and associates a stream with it. Fopen returns a 
pointer to be used to identify the stream in subsequent operations. 


Type is a character string having one of the following values: 


ad open for reading 

nw create for writing 

nan append; open for writing at end of file, or create for writing 
tr" open for update (reading and writing) 

"wt" create for update 

"a" append; open or create for update at end of file 





Freopen substitutes the named file in place of the open stream. It returns the original value of 
stream. The original stream is closed, regardless of whether the open ultimately succeeds. 


Freopen is typically used to attach the preopened constant names stdin, stdout, and stderr to 
specified files. 


Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or pipe(2). 
The type of the stream must agree with the mode of the open file. 


When a file is opened for update, both input and output may be done on the resulting stream. 
However, output may not be directly followed by input without an intervening fseek or rewind, 
and input may not be directly followed by output without an intervening fseek, rewind, or an 
input operation which encounters end of file. 


SEE ALSO 
open(2), fclose(3S). 


DIAGNOSTICS 
Fopen and freopen return the pointer NULL if file-name cannot be accessed. 
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NAME 





fread, fwrite - buffered binary input/output 
SYNOPSIS 
#include <stdio.h> 


int fread ((char +) ptr, sizeof (sptr), nitems, stream) 
FILE «stream; | 


int fwrite ((char +s) ptr, sizeof (sptr), nitems, stream) 
FILE sstream; 
DESCRIPTION | 
Fread reads, into a block beginning at ptr, nitems of data of the type of «ptr from the named 
input stream. It returns the number of items actually read. 
Fwrite appends at most nitems of data of the type of «ptr beginning at ptr to the named output 
stream. \t returns the number of items actually written. 
SEE ALSO | 
read(2), write(2), fopen(3S), getc(3S), putc(3S), gets(3S), puts(SS), printf(3S), scanf(3S). 
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NAME 





frexp, ldexp, modf - split into mantissa and exponent 


SYNOPSIS 
double frexp (value, eptr) 
double value; 
int septr; 
double Idexp (value, exp) 
double value; 


double modf (value, iptr) 
double value, siptr; 


DESCRIPTION 
Frexp returns the mantissa of a double va/ue as a double quantity, x, of magnitude less than 1 
and stores an integer n such that va/ue = x+2ssn indirectly through eptr. 


Ldexp returns the quantity value +2+sexp. 


Modf returns the positive fractional part of value and stores the integer part indirectly through 
iptr. 
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NAME 
fseek, ftell, rewind - reposition a stream 


SYNOPSIS 
#include <stdio.h> 


int fseek (stream, offset, ptrname) 
FILE «stream; 

long offset; 

int ptrname; 


long ftell (stream) 
FILE «stream; 





rewind(stream) 
FILE «stream; 


DESCRIPTION 
_ Fseek sets the position of the next input or output operation on the stream. The new position is 
at the signed distance offset bytes from the beginning, the current position, or the end of the 
file, according as ptrname has the value 0, 1, or 2. 


Fseek undoes any effects of ungetc(3S). 
After fseek or rewind, the next operation on an update file may be either input or output. 


Ftell returns the current value of the offset relative to the beginning of the file associated with 
the named stream. The offset is measured in bytes. 


Rewind (stream) is equivalent to fseek(stream, OL, 0). 


SEE ALSO 
Iseek(2), fopen(3S). 


DIAGNOSTICS 
Fseek returns non-zero for improper seeks, otherwise zero. 








Page 1 March 27, 1984 


GAMMA(3M) GAMMA(3M) 


NAME 





gamma - log gamma function 


SYNOPSIS 
f#include <math.h> 
extern int signgam; 
double gamma (x) 
double x; 
DESCRIPTION | 
Gamma returns In [T'( |x 1)|. The sign of '( | x |) is returned in the external integer signgam. 
The following C program fragment might be used to calculate I: 
y = gamma (x); 
if (y > 88.0) 
error (); 
y = exp (y) « signgam; 
DIAGNOSTICS 
For negative integer arguments, a huge value is returned, and errno is set to EDOM. 
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NAME 





getc, getchar, fgetc, getw - get character or word from stream 


SYNOPSIS 
#include <stdio.h> 


int getc (stream) 
FILE «stream; 


int getchar () 
int fgetc (stream) 
FILE «stream; 
int getw (stream) 
FILE «stream; 


DESCRIPTION 
Getc returns the next character from the named input stream. 


Getchar() is identical to getc (stdin). 


Fgetc behaves like getc, but is a genuine function, not a macro; it may therefore be used as an 
argument. Fgetc runs more slowly than getc, but takes less space per invocation. 


Getw returns the next word from the named input stream. It returns the constant EOF upon end 
of file or error, but since that is a valid integer value, feof and ferror(3S) should be used to 
check the success of getw. Getw assumes no special alignment in the file. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). 
DIAGNOSTICS | 
These functions return the integer constant EOF at end of file or upon read error. 


A stop with message “Reading bad file” means that an attempt has been made to read from a 
stream that has not been opened for reading by fopen. 





BUGS 
Getc and its variant getchar return EOF on end of file; this is wiser than, but incompatible with, 
the older getchar(3S). 
Because it is implemented as a macro, gefc treats incorrectly a stream argument with side 
effects. In particular, getc(sf+--+-); doesn’t work sensibly. 
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NAME 





getenv - value for environment name 


SYNOPSIS 
char «getenv (name) 
char sname; 
DESCRIPTION 
Getenv searches the environment list (see environ(7)) for a string of the form name=value and 
returns value if such a string is present, otherwise 0 (NULL). 
SEE ALSO 
environ(7). 








GETGRENT(3C) . GETGRENT(3C) 


NAME 





getgrent, getgrgid, getgrnam, setgrent, endgrent - get group file entry 
SYNOPSIS 

#include <grp.h> 

struct group sgetgrent ( ); 

struct group «getgrgid (gid) 

int gid; | 

struct group «getgrnam (name) 

char «name; 

int setgrent ( ); 

int endgrent ( ); 


DESCRIPTION 
Getgrent, getgrgid and getgrnam each return pointers to an object with the following structure 
containing the broken-out fields of a fine in the group file. 


struct group {/* see getgrent(3) */ 
char *gr_name; 
char “gr_passwd; 
int gr_gid; 
char ““gr_mem; 





} 
The members of this structure are: 
gr_name The name of the group. 
gr_passwd __ The encrypted password of the group. 
gr_gid The numerical group ID. 
gr_mem Null-terminated vector of pointers to the individual member names. 


Getgrent reads the next line of the file, so successive calls may be used to search the entire 
file. Getgrgid and getgrnam search from the beginning of the file until a matching gid or name 
is found, or EOF is encountered. 


A call to setgrent has the effect of rewinding the group file to allow repeated searches. 
Endgrent may be called to close the group file when processing is complete. 


FILES 
/etc/group 


SEE ALSO 

getlogin(3C), getpwent(3C), group(5). 
DIAGNOSTICS 

A null pointer (0) is returned on EOF or error.. 


BUGS 
All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 
getlogin - get login name 


SYNOPSIS 
char sgetlogin ( ); 


DESCRIPTION 
Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunc- 
tion with getpwnam to locate the correct password file entry when the same user ID is shared by 
several login names. 


If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The 
correct procedure for determining the login name is to call cuserid, or to call getlogin and if it 
fails, to call getpwuid. _ 





FILES 
/etc/utmp 


SEE ALSO 

cuserid(3S), getgrent(3C), getpwent(3C), utmp(5). 
DIAGNOSTICS _ 

Returns NULL if name not found. 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
getopt - get option letter from argv | 


SYNOPSIS 
int getopt (argc, argv, optstring) 
int argc; 
char «argv; 
char soptstring; 
extern char soptarg; 
extern int optind; 


DESCRIPTION 
Getopt returns the next option letter in argv that matches a letter in optstring. Optstring is a 
string of recognized option letters; if a letter is followed by a colon, the option is expected to 
have an argument that may or may not be separated from it by white space. Optarg is set to 
point to the start of the option argument on return from getopt. 


Getopt places in optind the argv index of the next argument to be processed. Because optind 
is external, it is normally initialized to zero automatically before the first call to getopt. 


When all options have been processed (i.e., up to the first non-option argument), getopt returns 
EOF. The special option - may be used to delimit the end of the options; EOF will be returned, 
and -- will be skipped. 


DIAGNOSTICS 
Getopt prints an error message on stderr and returns a question mark (?) when it encounters 
an option letter not included in optstring. 


EXAMPLE 
The following code fragment shows how one might process the arguments for a command that 
can take the mutually exclusive options a and b, and the options f and o, both of which require 
arguments: 


main (argc, argv) 

int argc; 

char «sargv; 

{ 
int c; 
extern int optind; 
extern char soptarg; 


while ((c = getopt (arge, argv, “abf:o:")) != EOF) 


switch (c) { 
case ‘a’: 
if (bflg) 
errtig+-+; 
else 
aflg+--+; 
break; 
case “b*: 
if (aflg) 
errflg+-+-; 
else 
bproc(); 
break; 
case ‘f’: 
ifile = optarg; 
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break; 
case ‘O°: 
Ofile = optarg; 
bufsiza = 512; 
break; 
case °?°: 
errfig+--+-; 
if (errfig) { 
fprintf (stderr, "usage: . . . "); 
exit (2); 


} 
for( ; optind < argc; optind+-+) { 
if (access (argv[optind], 4)) { 
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NAME 
getpass - read a password 
SYNOPSIS 
char «getpass (prompt) 
char «prompt; 
DESCRIPTION | 
Getpass reads a password from the file /dev/tty, or if that cannot be opened, from the standard 


input, after prompting with the null-terminated string prompt and disabling echoing. A pointer is 
returned to a null-terminated string of at most 8 characters. 


FILES 
/dev/tty 


SEE ALSO 
crypt(3C). 
BUGS 
The return value points to static data whose content is overwritten by each call. 
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NAME 





getpw - get name from UID | 


SYNOPSIS 
getpw (uid, buf) 
int uid; 
char «buf; 
DESCRIPTION 
Getpw searches the password file for the (numerical) uid, and fills in buf with the corresponding 
fine; it returns non-zero if uid could not be found. The line is null-terminated. 


This routine is included only for compatibility with prior systems and should not be used; see 
getpwent(3C) for routines to use instead. 


FILES 
/etc/passwd 


SEE ALSO 
getpwent(3C), passwd(5). 


DIAGNOSTICS 
Non-zero return on error. 
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NAME 





getpwent, getpwuid, getpwnam, setpwent, endpwent - get password file entry 


SYNOPSIS 
#include <pwd.h> 


struct passwd sgetpwent ( ); 


struct passwd sgetpwuid (uid) 
int uid; 


struct passwd sgetpwnam (name) 
char «name; 


int setpwent ( ); 
int endpwent ( ); 


DESCRIPTION 
Getpwent, getpwuid and getpwnam each returns a pointer to an object with the following struc- 
ture containing the broken-out fields of a line in the password file. 


struct passwd { 
char ‘*pw_name; 
char ‘“*pw_passwd; 
int pw_uid; 
int pw_gid; 
char “pw_age; 
char “*pw_comment; 
char ‘“pw_gecos; 
char “pw_dir; 
char ‘“pw_shell; 





}; 
The pw_comment field is unused; the others have meanings described in passwd(5). 
Getpwent reads the next line in the file, so successive calls can be used to search the entire 


file. Getpwuid and getpwnam search from the beginning of the file until a matching uid or 
name is found, or EOF is encountered. 


A call to setpwent has the effect of rewinding the password file to allow repeated searches. 
Endpwent may be called to close the password file when processing is complete. 


FILES 
/etc/passwd 


SEE ALSO 

getlogin(3C), getgrent(3C), passwd(5). 
DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 


BUGS 
All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 

gets, fgets - get a string from a stream 
SYNOPSIS 

#include <stdio.h> 

char sgets (s) 

char <s; 

char «fgets (s, n, stream) 

char +s; 

int n; 

FILE «stream; 
DESCRIPTION 


Gets reads a string into s from the standard input stream stdin. The string is terminated by a 
new-line character, which is replaced in s by a null character. Gets returns its argument. 


Fgets reads n-1 characters, or up to a new-line character (which is retained), whichever comes 
first, from the stream into the string s. The last character read into s is followed by a null char- 
acter. Fgets returns its first argument. 

SEE ALSO 
ferror(3S), fopen(3S), fread(3S), getc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 

| Gets and fgets return the constant pointer NULL upon end-of-file or error. 

NOTE. 
Gets deletes the new-line ending its input, but fgets keeps it. 
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HYPOT(3M) 


NAME 
hypot - Euclidean distance 


SYNOPSIS 
#include <math.h> 


double hypot (x, y) 
double x, y; 


DESCRIPTION 
Hypot returns 


sqrt(x«x + ysy), 


taking precautions against unwarranted overflows. 


SEE ALSO 
sqrt(3M). 
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HYPOT (3M) 
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NAME 


IStol, Itol3 - convert between 3-byte integers and long integers 


SYNOPSIS 


I3tol (ip, cp, n) 
long sip; 

char scp; 

int n; 

Itol3 (cp, ip, n) 
char scp; 

long ip; 

int n; 


DESCRIPTION 


L3tol converts a list of n three-byte integers packed into a character string pointed to by cp into 
a list of long integers pointed to by /p. 


Ltol3 performs the reverse conversion from long integers (/p) to three-byte integers (cp). 


_ These functions are useful for file-system maintenance where the block numbers are three 


bytes long. 


SEE ALSO 
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fs(5). 
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NAME 
logname - login name of user 


SYNOPSIS 
char slogname(); 
DESCRIPTION 
Logname returns a pointer to the null-terminated login name; it extracts the SLOGNAME variable 
from the user’s environment. | 
This routine is kept in /lib/libPW.a. 
FILES 
/etc/profile 


SEE ALSO 
env(1), login(1), profile(5), environ(7). 
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NAME 
lsearch - linear search and update 

SYNOPSIS 
char slsearch (key, base, nelp, width, compar) 
char «key; 
char «base; 
int snelp; 
int width; 
int (*compar)(); 

DESCRIPTION 
Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm Q. It returns a pointer 
into a table indicating the location at which a datum may be found. If the item does not occur, it 
is added at the end of the table. The first argument is a pointer to the datum to be located in 
the table. The second argument is a pointer to the base of the table. The third is the address of 
an integer containing the number of items in the table. It is incremented if the item is added to 
the table. The fourth is the width of an element in bytes. The last is the name of the com- 
parison routine. It is called with two arguments which are pointers to the elements being com- 
pared. The routine must return zero if the items are equal and non-zero otherwise. 

BUGS 
Unpredictable events can occur if there is not enough room in the table to add a new item. 

SEE ALSO 
bsearch(3C), qsort(3C). 
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NAME 
malloc, free, realloc, calloc - main memory allocator 

SYNOPSIS 
char «malloc (size) unsigned size; 
free (ptr) 
char sptr; 
char srealloc (ptr, size) 
char «ptr; 
unsigned size; 
char scalioc (nelem, elsize) 
unsigned elem, elsize; 

DESCRIPTION 
Malloc and free provide a simple general-purpose memory allocation package. Malloc returns 

a pointer to a block of at least size bytes beginning on a word boundary. 

The argument to free is a pointer to a block previously allocated by malloc; this space is made 
available for further allocation, but its contents are left undisturbed. 
Needless to say, grave disorder will result if the space assigned by malioc is overrun or if some 
random number is handed to free. | 
Malloc allocates the first big enough contiguous reach of free space found in a circular search 
from the last block allocated or freed, coalescing adjacent free blocks as it searches. It calls | 
sbrk (see brk(2)) to get more memory from the system when there is no suitable space already 
free. | 
Realloc changes the size of the block pointed to by pir to size bytes and returns a pointer to the 
(possibly moved) block. The contents will be unchanged up to the lesser of the new and old 
sizes. | 
Realloc also works if pir points to a block freed since the last call of malloc, realloc, or calloc; 
thus sequences of free, malloc and realloc can exploit the search strategy of malloc to do 
storage compaction. 
Calfoc allocates space for an array of nelem elements of size e/size. The space is initialized to 
zeros. 
Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer 
coercion) for storage of any type of object. 

DIAGNOSTICS 
Malloc, realloc and calfoc return a null pointer (0) if there is no available memory or if the arena 
has been detectably corrupted by storing outside the bounds of a block. When realioc returns 0, 
the block pointed to by pir may be destroyed. 
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NAME 





mktemp - make a unique file name 


SYNOPSIS 
char «mktemp (template) 
char «template; 


DESCRIPTION 
Mktemp replaces template by a unique file name, and returns the address of the template. The 


. template should look like a file name with six trailing Xs, which will be replaced with a letter and 
the current process ID. The letter will be chosen so that the resulting name does not duplicate 
an existing file. 


SEE ALSO 
getpid(2). 


BUGS 
It is possible to run out of letters. 
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NAME 





monitor - prepare execution profile 


SYNOPSIS 
monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (slowpc){ ), (shighpc)( ); 
short buffer{ ]; 
int bufsize, nfunc; 
DESCRIPTION 
An executable program created by cc -p automatically includes calls for monitor with default 
parameters; monitor needn't be called explicitly except to gain fine control over profiling. 


Monitor is an interface to profil(2). Lowpc and highpc are the addresses of two functions; 
buffer is the address of a (user supplied) array of bufsize short integers. Monitor arranges to 
record a histogram of periodically sampled values of the program counter, and of counts of calls 
of certain functions, in the buffer. The lowest address sampled is that of lowpe and the highest 
is just below highpc. At most nfunc call counts can be kept; only calls of functions compiled 
with the profiling option -p of cc(1) are recorded. For the results to be significant, especially 
where there are small, heavily used routines, it is suggested that the buffer be no more than a 
few times smaller than the range of locations sampled. 


To profile the entire program, it is sufficient to use 
extern etext(); 


monitor(2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text, see end(3C). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor(0); 

prof(1) can then be used to examine the results. 





FILES 
mon.out 


SEE ALSO 
cc(1), prof(1), profil(2). 
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NAME 





nlist - get entries from name list 


SYNOPSIS 
#include <a.out.h> 
nlist (file-name, ni) 
char <file-name; 
struct niist nil J; 


DESCRIPTION 
Niist examines the name list in the given executable output file and selectively extracts a list of 
values. The name list consists of an array of structures containing names, types and values. 
The list is terminated with a null name. Each name is looked up in the name list of the file. If 
the name is found, the type and value of the name are inserted in the next two fields. If the 
name is not found, both entries are set to 0. See a.out(5) for a discussion of the symbol table 
structure. 


This subroutine is useful for examining the system name list kept in the file /sys3. In this way 
programs can obtain system addresses that are up to date. 
NOTES 
The system name is /sys3, not /unix. 
SEE ALSO 
a.out(5). 


DIAGNOSTICS 
Ail type entries are set to 0 if the file cannot be found or if it is not a valid namelist. 
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NAME 





perror, sys_errlist, sys_nerr, errno - system error messages 


SYNOPSIS 
perror (s) 
char ss; 
int sys_nerr; 
char «sys_errlist[ ]; 


int errno; 


DESCRIPTION 
Perror produces a short error message on the standard error, describing the last error encoun- 
tered during a system call from a C program. First the argument string s is printed, then a 
colon, then the message and a new-line. To be of most use, the argument string should be the 
name of the program that incurred the error. The error number is taken from the external vari- 
able errno, which is set when errors occur but not cleared when non-erroneous calls are made. 


To simplify variant formatting of messages, the vector of message strings sys_errlist is pro- 
vided; errno can be used as an index in this table to get the message string without the new- 
line. Sys_nerr is the largest message number provided for in the table; it should be checked 
because new error codes may be added to the system before they are added to the table. 


SEE ALSO 
intro(2). 
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NAME 





plot - graphics interface subroutines 


SYNOPSIS 
openpi () 
erase () 


label (s) 
char +S; 


line (x1, y1, x2, y2) 
circle (x, y, fr) 

arc (x, y, x0, yO, x1, 
move (x, y) 

cont (x, y) 

point (x, y) 

linemod (s) 

char +s; 

space (x0, y0, x1, y1) 
closepl () 


DESCRIPTION 
These subroutines generate graphic output in a relatively device-independent manner. See 
plot(S) for a description of their effect. Openp! must be used before any of the others to open 
the device for writing. Closep/ flushes the output. 


String arguments to /abel and linemod are terminated by nulls and do not contain new-lines. 





The library files listed below provide several flavors of these routines.’ 


FILES 
/Jusr/lib/libplot.a produces output for tplot(1G) filters 
/usr/lib/lib300.a for DASI 300 
/usr/lib/tib300s.a for DAS! 300s 
/usr/lib/lib450.a for DASI 450 
/usr/lib/lib4014.a for Tektronix 4014 


SEE ALSO 
graph(1G), tplot(1G), plot(5). 
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NAME 
popen, pclose - initiate I/O to/from a process 

SYNOPSIS 
#include <stdio.h> 
FILE spopen (command, type) 
char «command, «type; 
int pclose (stream) 

. FILE «stream; 

DESCRIPTION 
The arguments to popen are pointers to null-terminated strings containing, respectively, a shell 
command line and an I/O mode, either r for reading or w for writing. Popen creates a pipe 
between the calling process and the command to be executed. The value returned is a stream 
pointer that can be used (as appropriate) to write to the standard input of the command or read 
from its standard output. 
A stream opened by popen should be closed by pclose, which waits for the associated process 
to terminate and returns the exit status of the command. 
Because open files are shared, a type r command may be used as an input filter, and a type w 
as an output filter. 

SEE ALSO 
pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 

DIAGNOSTICS 
Popen returns a null pointer if files or processes cannot be created, or if the shell cannot be 
accessed. 
Pclose returns -1 if stream is not associated with a “popened” command. 


BUGS 
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Only one stream opened by popen can be in use at once. 


Buffered reading before opening an input filter may leave the standard input of that filter mispo- 
sitioned. Similar problems with an output filter may be forestalled by careful buffer flushing, e.g. 
with fflush; see fclose (3S). 
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NAME 


printf, fprintf, sprintf - output formatters 


SYNOPSIS 


#include <stdio.h> 


int printf (format [, arg]... ) 

char «format; 

int fprintf (stream, format [ , arg]... ) 
FILE «stream; 

char format; 

int sprintf (s, format [, arg]... ) 
char «s, format; 


DESCRIPTION 
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Printf places output on the standard output stream stdout. Fprintf places output on the named 
output stream. Sprintf places “output”, followed by the null character (\0) in consecutive bytes 
starting at «s; it is the user's responsibility to ensure that enough storage is available. Each 
function returns the number of characters transmitted (not including the \Q in the case of 
Sprintf), or a negative value if an output error was encountered. 


Each of these functions converts, formats, and prints its args under control of the format. The 
format is a character string that contains two types of objects: plain characters, which are simply 
copied to the output stream, and conversion specifications, each of which results in fetching of 
zero or more args. The results are undefined if there are insufficient args for the format. If the 
format is exhausted while args remain, the excess args are simply ignored. 


Each conversion specification is introduced by the character %. After the %, the following 
appear in sequence: 


Zero or more flags, which modify the meaning of the conversion specification. 


An optional decimal digit string specifying a minimum field width. \f the converted value 
has fewer characters than the field width, it will be padded on the left (or right, if the 
left-adjustment flag (see below) has been given) to the field width; 


A precision that gives the minimum number of digits to appear for the d, 0, u, x, or X 
conversions, the number of digits to appear after the decimal point for the e and f 
conversions, the maximum number of significant digits for the g conversion, or the max- 
imum number of characters to be printed from a string in s conversion. The precision 
takes the form of a period (.) followed by a decimal digit string: a null digit string is 
treated as zero. 


An optional I specifying that a following d, 0, u, x, or X conversion character applies to a 
long integer arg. 


A character that indicates the type of conversion to be applied. 


A field width or precision may be indicated by an asterisk (*) instead of a digit string. In this 
case, an integer arg supplies the field width or precision. The arg that is actually converted is 
not fetched until the conversion letter is seen, so the args specifying field width or precision 
must appear before the arg (if any) to be converted. 


The flag characters and their meanings are: 
- The result of the conversion will be left-justified within the field. 
The result of a signed conversion will always begin with a sign (+- or -). 
blank If the first character of a signed conversion is not a sign, a blank will be prepended to 


the result. This implies that if the blank and -+- flags both appear, the blank flag will 
be ignored. 
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# This flag specifies that the value is to be converted to an “alternate form.” For c, d, 
s, and u conversions, the flag has no effect. For o conversion, it increases the preci- 
sion to force the first digit of the result to be a zero. For x (X) conversion, a non- 
zero result will have Ox (OX) prepended to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow the point (normally, 
a decimal point appears in the result of these conversions only if a digit follows it). 
For g and G conversions, trailing zeroes will not be removed from the result (which 
they normally are). 


The conversion characters and their meanings are: 


d,o,u,x,X The integer arg is converted to signed decimal, unsigned octal, decimal, or hexade- 
cimal notation (x and X), respectively; the letters abcdef are used for x conversion 
and the letters ABCDEF for X conversion. The precision specifies the minimum 
number of digits to appear; if the value being converted can be represented in fewer 
digits, it will be expanded with leading zeroes. The default precision is 1. The result 
of converting a zero value with a precision of zero is a null string (unless the conver- 
sion is 0, x, or X and the # flag is present). 

f The float or double arg is converted to decimal notation in the style “[-]ddd.ddd”, 
where the number of digits after the decimal point is equal to the precision specifica- 
tion. If the precision is missing, 6 digits are output; if the precision is explicitly 0, no 
decimal point appears. 

e,E The float or double arg is converted in the style “[-]d.ddde-+-dd”, where there is one 
digit before the decimal point and the number of digits after it is equal to the preci- 
sion; when the precision is missing, 6 digits are produced; if the precision is zero, no 
decimal point appears. The E format code will produce a number with E instead of e 
introducing the exponent. The exponent always contains exactly two digits. 

g,G The float or double arg is printed in style f or e (or in style E in the case of a G for- 
mat code), with the precision specifying the number of significant digits. The style 
used depends on the value converted: style e will be used only if the exponent result- 
ing from the conversion is less than -4 or greater than the precision. Trailing zeroes 
are removed from the result; a decimal point appears only if it is followed by a digit. 

c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters from the string are 
printed until a null character (\O0) is encountered or the number of characters indi- 
cated by the precision specification is reached. If the precision is missing, it is taken 
to be infinite, so all characters up to the first null character are printed. 

% Print a %; no argument is converted. 


In no case does a non-existent or small field width cause truncation of a field; if the result of a 
conversion is wider than the field width, the field is simply expanded to contain the conversion 
result. Characters generated by printf and fprintf are printed as if putchar had been called (see 
putc(3S)). 

EXAMPLES 
To print a date and time in the form “Sunday, July 3, 10:02”, where weekday and month are 
pointers to null-terminated strings: 


printf("%s, %S %d, %.2d:%.2d", weekday, month, day, hour, min); 
To print 7 to 5 decimal places: 
printf("pi = %.5f", 4xatan(1.0)); 


SEE ALSO 
ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 





putc, putchar, fputc, putw - put character or word on a stream 


SYNOPSIS 
#include <stdio.h> 


int putc (c, stream) 
char c; 
FILE «stream; 


putchar (c) 
fputc (c, stream) 
FILE «stream; 
putw (w, stream) 
int w; 
FILE «stream; 
DESCRIPTION 
Putc appends the character c to the named output stream. It returns the character written. 


Putchar(c) is defined as putc(c, stdout). 


Fputc behaves like putc, but is a genuine function rather than a macro; it may therefore be 
used as an argument. Fputc runs more slowly than putc, but takes less space per invocation. 


Putw appends the word (i.e., integer) w to the output stream. Putw neither assumes nor 
causes special alignment in the file. 


The standard stream stdout is normally buffered if and only if the output does not refer to a ter- 
minal; this default may be changed by setbuf(3S). The standard stream stderr is by default 
unbuffered unconditionally, but use of freopen(3S) will cause it to become unbuffered; setbuf, 
again, will set the state to whatever is desired. When an output stream is unbuffered informa- 
tion appears on the destination file or terminal as soon as written; when it is buffered many 
characters are saved up and written as a block. See also fflush(3S). 


SEE ALSO 
ferror(3S), fopen(3S), fwrite(3S), getc(3S), printf(3S), puts(3S). 

DIAGNOSTICS 
These functions return the constant EOF upon error. Since this is a good integer, ferror(3S) 
should be used to detect putw errors. 

BUGS 


Because it is implemented as a macro, putc treats incorrectly a stream argument with side 
effects. In particular, putc(c, «f+--+-); doesn't work sensibly. 
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NAME 
putpwent - write password file entry 


SYNOPSIS 
#include <pwd.h> 


int putpwent (p, f) 

struct passwd <p; 

FILE ef; 
DESCRIPTION 


Putpwent is the inverse of getpwent(3C). Given a pointer to a passwd structure created by 


getpwent (or getpwuid(3C) or getpwnam(3C)), putpwuid writes a line on the stream f which 
matches the format of /etc/passwd. 


DIAGNOSTICS 
Putpwent returns non-zero if an error was detected during its operation, otherwise zero. 
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NAME 





puts, fputs - put a string on a stream 
SYNOPSIS 

#include <stdio.h> 

int puts (s) 

char <s; 


int fputs (s, stream) 
char +s; 
FILE «stream; 


DESCRIPTION , 
Puts copies the null-terminated string s to the standard output stream stdout and appends a 
new-line character. 


Fputs copies the null-terminated string s to the named output stream. 
Neither routine copies the terminating null character. 


DIAGNOSTICS 
Both routines return EOF on error. 


SEE ALSO 
ferror(3S), fopen(3S), fwrite(3S), gets(3S), printf(3S), putc(3S). 


NOTES 
Puts appends a new-line, fputs does not. 
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NAME 
qsort - quicker sort 


SYNOPSIS 
qsort (base, nei, width, compar) 
char sbase; | 
int nel, width; 
int (scompar)( ); 


DESCRIPTION 
Qsort is an implementation of the quicker-sort algorithm. The first argument is a pointer to the 
base of the data; the second is the number of elements; the third is the width of an element in 
bytes; the last is the name of the comparison routine. It is called with two arguments which are 
pointers to the elements being compared. The routine must return an integer less than, equal 
to, or greater than 0 according as the first argument is to be considered less than, equal to, or 
greater than the second. 


SEE ALSO 
sort(1), bsearch(3C), Isearch(3C), stremp(3C). 
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NAME 





rand, srand - random number generator 


SYNOPSIS 
srand (seed) 
unsigned seed; 


rand ( ) 


DESCRIPTION 
Rand uses a multiplicative congruential random number generator with period 2°? to return suc- 
cessive pseudo-random numbers in the range from 0 to 2!°-1. 


The generator is reinitialized by calling srand with 1 as argument. It can be set to a random 
starting point by calling srand with whatever you like as argument. 
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NAME 


regex, regcomp - regular expression compile/execute 


SYNOPSIS 


char «regcomp(string1[,string2, ...],0); 
char <string1, «string2, ...; 

char s«regex(re,subject[,ret0, ...]); 
char sre, «subject, <«ret0, ...; 


DESCRIPTION 


Regcmp compiles a regular expression and returns a pointer to the compiled form. Malloc(3C) 
is used to create space for the vector. It is the user's responsibility to free unneeded space so 
allocated. A zero return from regcomp indicates an incorrect argument. Regcmp(1) has been 
written to generally preclude the need for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional arguments are passed 
to receive values back. Regex returns zero on failure or a pointer to the next unmatched char- 
acter on success. A global character pointer _foc? points to where the match began. Regcmp 
and regex were mostly borrowed from the editor, ed(1) however, the syntax and semantics 
have been changed slightly. The following are the valid symbols and their associated meanings. 


[]*.. | These symbols retain their current meaning. 
$ Matches the end of the string, \n matches the new-line. 


- Within brackets the minus means through. For example, [a-z] is equivalent to 
{abcd ...xyz]. The - can appear as itself only if used as the last or first character. For 
example, the character class expression []-] matches the characters ] and -. 


2 A regular expression followed by 4- means one or more times. For example, [0-9]+- is 
equivalent to [C-9][0-9] +. 


{m} {m,} {m,u} 
Integer values enclosed in {} indicate the number of times the preceding regular 
expression is to be applied. m is the minimum number and u is a number, less than 
256, which is the maximum. If only m is present (e.g., {m}), it indicates the exact 
number of times the regular expression is to be applied. {m,} is analogous to 
{m, infinity}. The plus (+) and star (*) operations are equivalent to {1,} and {0,} 
respectively. 


(...)$n The value of the enclosed regular expression is to be returned. The value will be 
stored in the (n-+-7)th argument following the subject argument. At present, at most 
ten enclosed regular expressions are allowed. Regex makes its assignments uncondi- 
tionally. 


Cece) Parentheses are used for grouping. An operator, e.g. +, +, { }, can work on a single 
character or a regular expression enclosed in parenthesis. For example, (a+(cb+-)+)$0. 


By necessity, all the above defined symbols are special. They must, therefore, be escaped to 
be used as themselves. 


EXAMPLES 
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Example 1: 
char «cursor, «newcursor, «ptr; 


newcursor = regex((ptr=regemp(""\n",0)),cursor); 
free(ptr); 
This example will match a leading new-line in the subject string pointed at by cursor. 


Example 2: 
char retO[9]; 
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char «newcursor, «name; 


name = regcmp("([A-Za-z][A-za-z0-9 ]{0,7})$0",0); 
newcursor = regex(name,"123Testing321",ret0); 
This example will match through the string “Testing3” and will return the address of the charac- 


ter after the last matched character (cursor+-11). The string “Testing3” will be copied to the 
character array ret0. 


Example 3: 
#include "file.i" 
char «string, «newcursor; 


newcursor = regex(name,string); 


This example applies a precompiled regular expression in file.i (see regemp(1)) against string. 
This routine is kept in /lib/libPW.a. 

SEE ALSO 
ed(1), regemp(1), free(3C), malloc(3C). 

BUGS 


The user program may run out of memory if regcmp is called iteratively without freeing the vec- 
tors no longer required. The following user-supplied replacement for malioc(3C) re-uses the 
same vector saving time and space: 


/x user's program +«/ 
malloc(n) { 


static int rebuf[256]; 
return &rebuf; 
} 
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NAME 


scanf, fscanf, sscanf - formatted input conversion 


SYNOPSIS 


#include <stdio.h> 


scant (format [ , pointer]... ) 
char «format; 


fscanf (stream, format [ , pointer]... ) 
FILE «stream; 
char «format; 


sscanf (s, format [ , pointer]... ) 


char <«s, «format; 


DESCRIPTION 


Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. 
Sscanf reads from the character string s. Each function reads characters, interprets them 
according to a format, and stores the results in its arguments. Each expects, as arguments, a 
control string format described below, and a set of pointer poe indicating where the con- 
verted input should be stored. 


The control string usually contains conversion specifications, which are used to direct interpreta- 
tion of input sequences. The control string may contain: 


1. Blanks, tabs, or new-lines, which cause input to be read up to the next non-white-space 
character. 

2. An ordinary character (not %), which must match the next character of the input stream. . 

3. Conversion specifications, consisting of the character %, an optional assignment suppress- 
ing character *, an optional numerical maximum field width, and a conversion character. 


A conversion specification directs the conversion of the next input field; the result is placed in 
the variable pointed to by the corresponding argument, unless assignment suppression was indi- 


cated by «. An input field is defined as a string of non-space characters; it extends to the next 
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inappropriate character or until the field width, if specified, is exhausted. 


The conversion character indicates the interpretation of the input field; the corresponding pointer 
argument must usually be of a restricted type. The following conversion characters are legal: 


% a single % is expected in the input at this point; no assignment is done. 

d a decimal integer is expected; the corresponding argument should be an integer pointer. 

oO an octal integer is expected; the corresponding argument should be an integer pointer. 

x a hexadecimal integer is expected; the corresponding argument should be an integer 
pointer. 

s a character string is expected; the corresponding argument should be a character 
pointer pointing to an array of characters large enough to accept the string and a ter- 
minating \0, which will be added automatically. The input field is terminated by a space 
character or a new-line. 

c a character is expected; the corresponding argument should be a character pointer. 
The normal skip over space characters is suppressed in this case; to read the next 
non-space character, use %1s. If a field width is given, the corresponding argument 
should refer to a character array; the indicated number of characters is read. 

e,f a floating point number is expected; the next field is converted accordingly and stored 
through the corresponding argument, which should be a pointer to a float. The input for- 
mat for floating point numbers is an optionally signed string of digits, possibly containing 
a decimal point, followed by an optional exponent field consisting of an E or an e, fol- 
lowed by an optionally signed integer. 
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[ indicates a string that is not to be delimited by space characters. The ieft bracket is fol- 
lowed by a set of characters and a right bracket; the characters between the brackets 
define a set of characters making up the string. If the first character is not a circumflex 
(“), the input field consists of all characters up to the first character that is not in the set 
between the brackets; if the first character after the left bracket is a “, the input field 
consists of all characters up to the first character that is in the set of the remaining char- 
acters between the brackets. The corresponding argument must point to a character 
array. 


The conversion characters d, 0, and x may be capitalized and/or preceded by | to indicate that a 
pointer to long rather than to int is in the argument list. Similarly, the conversion characters e 
and f may be capitalized and/or preceded by | to indicate that a pointer to double rather than to 
float is in the argument list. The character h will, some time in the future, indicate short data 
items. 

Scanf conversion terminates at EOF, at the end of the control string, or when an input character 
conflicts with the control string. In the latter case, the offending character is left unread in the 
input stream. | 


Scanf returns the number of successfully matched and assigned input items; this number can 
be zero in the event of an early conflict between an input character and the control string. If the 
input ends before the first conflict or conversion, EOF is returned. 


EXAMPLES 
The call: 


int i; float x; char name[50]; 
scanf ("%d%f%s", &i, &x, name); 


with the input line: 
25 54.32E—1 thompson 
will assign to / the value 25, to x the value 5.432, and name will contain thompson\0. Or: 


int i; float x; char name[50]; 
scanf ("%2d%f%+d%[1234567890]", &i, &x, name); 


with input: 
56789 0123 56a72 


will assign 56 to /, 789.0 to x, skip 0123, and place the string 56\0 in name. The next call to 
getchar (see getc(3S)) will return a. 

SEE ALSO 
atof(3C), getc(3S), printf(3S). 





NOTE 
Trailing white space (including a new-line) is left unread unless matched in the control string. 
DIAGNOSTICS : 
These functions return EOF on end of input and a short count for missing or illegal data items. 
BUGS | 
The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 





setbuf - assign buffering to a stream 


SYNOPSIS 
#include <stdio.h> 


setbuf (stream, buf) 
FILE «stream; 
char sbuf; 


DESCRIPTION 
Setbuf is used after a stream has been opened but before it is read or written. It causes the 
character array buf to be used instead of an automatically allocated buffer. If buf is the con- 
stant pointer NULL, input/output will be completely unbuffered. 


A manifest constant BUFSIZ tells how big an array is needed: 
char buf[BUFSIZ]; 


A buffer is normally obtained from mailoc(3C) upon the first gefc or putc(3S) on the file, except 
that output streams directed to terminals, and the standard error stream stderr are normally not 
buffered. 


A common source of error is allocation of buffer space as an “automatic” variable in a code 
block, and then failing to close the stream in the same block. 


SEE ALSO 
fopen(3S), getc(3S), malloc(3C), putc(3S). 
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NAME 
setimp, longjmp - non-local goto 

SYNOPSIS 
#include <setjmp.h> 
int setimp (env) 
jmp_buf env; 
longjmp (env, val) 
jmp_buf env; 

DESCRIPTION 
These routines are useful for dealing with errors and interrupts encountered in a low-level sub- 
routine of a program. 
Setmp saves its stack environment in env for later use by jongjmp. It returns value 0. 
Longmp restores the environment saved by the last call of setjnp. It then returns in such a 
way that execution continues as if the call of setjmp had just returned the value va/ to the 
corresponding call to setjmp, which must not itself have returned in the interim. Longgmp can- 
not return the value 0. If jonggnp is invoked with a second argument of 0, it will return 1. All 
accessible data have values as of the time jongjmp was called. 


SEE ALSO 
signal(2). 


SINH(3M) | SINH(3M) 


NAME 





sinh, cosh, tanh - hyperbolic functions 7 
SYNOPSIS 
#include <math.h> 


double sinh (x) 
double x; 


double cosh (x) 
double x; 


double tanh (x) 
double x; 


DESCRIPTION 
These functions compute the designated hyperbolic functions for real arguments. 


DIAGNOSTICS | 
Sinh and cosh return a huge value of appropriate sign when the correct value would overflow. 
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NAME 


sleep - suspend execution for interval 


SYNOPSIS 


unsigned sleep (seconds) 
unsigned seconds; 


DESCRIPTION 


The current process is suspended from execution for the number of seconds specified by the 
argument. The actual suspension time may be less than that requested for two reasons: (1) 
Because scheduled wakeups occur at fixed 1-second intervals, and (2) because any caught sig- 
nal will terminate the s/eep following execution of that signal’s catching routine. Also, the 
suspension time may be longer than requested by an arbitrary amount due to the scheduling of 
other activity in the system. The value returned by s/eep will be the “unslept” amount (the 
requested time minus the time actually slept) in case the caller had an alarm set to go off earlier 
than the end of the requested s/eep time, or premature arousal due to another caught signal. 


The routine is implemented by setting an alarm signal and pausing until it (or some other signal) 
occurs. The previous state of the alarm signal is saved and restored. The calling program may 
have set up an alarm signal before calling sleep; if the sleep time exceeds the time till such 
alarm signal, the process sleeps only until the alarm signal would have occurred, and the caller's 
alarm catch routine is executed just before the s/eep routine returns, but if the sleep time is less 
than the time till such alarm, the prior alarm time is reset to go off at the same time it would 
have without the intervening s/eep. 


SEE ALSO 
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alarm(2), pause(2), signal(2). 
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NAME 


ssignal, gsignal - software signals 


SYNOPSIS 


#include <signal.h> 


int (sssignal (sig, action))( ) 
int sig, (s«action)( ); 

int gsignal (sig) 

int sig; 


DESCRIPTION 


NOTES 


Page 1 


Ssignal and gsignal implement a software facility similar to signal(2). This facility is used by 
the Standard C Library to enable the user to indicate the disposition of error conditions, and is 
also made available to the user for his own purposes. 


Software signals made available to users are associated with integers in the inclusive range 1 
through 15. An action for a software signal is established by a call to ssignal, and a software 
signal is raised by a call to gsignal. Raising a software signal causes the action established for 
that signal to be taken. 


The first argument to ssignal is a number identifying the type of signal for which an action is to 
be established. The second argument defines the action; it is either the name of a (user defined) 
action function or one of the manifest constants SIG_DFL (default) or SIG_IGN (ignore). Ssignal 
returns the action previously established for that signal type; if no action has been established or 
the signal number is illegal, ssigna/ returns SIG_DFL. 


Gsignal raises the signal identified by its argument, sig: 


If an action function has been established for sig, then that action is reset to SIG_DFL Jane 
the action function is entered with argument sig. Gsignal returns the value returned to it 
by the action function. 


If the action for sig is SIG_IGN, gsignal returns the value 1 and takes no other action. 
if the action for sig is SIG_DFL, gsignal returns the value 0 and takes no other action. 


lf sig has an illegal value or no action was ever specified for sig, gsignal returns the value 
0 and takes no other action. 


There are some additional signals with numbers outside the range 1 through 15 which are used 
by the Standard C Library to indicate error conditions. Thus, some signal numbers outside the 
range 1 through 15 are legal, although their use may interfere with the operation of the Standard 
C Library. 
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NAME 
Stdio - standard buffered input/output package 


SYNOPSIS 
#include <stdio.h> 
FILE «stdin, «stdout, «stderr; 


DESCRIPTION 
The functions described in the entries of sub-class 3S of this manual constitute an efficient, 
user-level /O buffering scheme. The in-line macros getc(3S) and putc(3S) handle characters 
quickly. The macros getchar, putchar, and the higher-level routines fgetc, fgets, fprintf, fputc, 
fputs, fread, fscanf, fwrite, gets, getw, printf, puts, putw, and scanf all use getc and putc; 
they can be freely intermixed. 


A file with associated buffering is called a stream and is declared to be a pointer to a defined 
type FILE. Fopen(3S) creates certain descriptive data for a stream and returns a pointer to 
designate the stream in all further transactions. Normally, there are 3 open streams with con- 
Stant pointers declared in the “include” file and associated with the standard open files: 


stdin standard input file 
stdout standard output file 
stderr standard error file. 
A constant “pointer” NULL (0) designates the null stream. 


An integer constant EOF (-1) is returned upon end-of-file or error by most integer functions that 
deal with streams (see the individual descriptions for details). 


Any program that uses this package must include the header file of pertinent macro definitions, 
as follows: | 


#include <stdio.h> 


The functions and constants mentioned in the entries of sub-class 3S of this manual are 
- declared in that “include” file and need no further declaration. The constants and the following 

“functions” are implemented as macros (redeciaration of these names is perilous): getc, 
getchar, putc, putchar, feof, ferror, and fileno. 

SEE ALSO 
open(2), close(2), read(2), write(2), ctermid(3S), cuserid(3S), fclose(3S), ferror(3S), fopen(3S), 
fread(3S), fseek(3S), getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), 
setbuf(3S), system(3S), tmpnam(3S). 

DIAGNOSTICS 


Invalid stream pointers will usually cause grave disorder, possibly including program termination. 
individual function descriptions describe the possible error conditions. 
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NAME 


Streat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, strspn, strcspn, 
strtok - string operations 


SYNOPSIS 
char +strcat (s1, s2) 
char «s1, «S2; 


char sstrncat (s1, s2, n) 
char «s1, +«s2; 
int n; 





int strcmp (s1, s2) 
char «si, «S2; 


int strncmp (s1, s2, n) 
char «s1, +«S2; 

int n; 

char «strcpy (s1, s2) 
char «si, +«S2; 


char «strncpy (s1, s2, n) 
char +s1, +S2; 

int n; 

int strien (s) 

char +s; 


char «strchr (s, c) 
char +S, Cc; 


char «strrchr (s, c) 
char +S, C; 


char «strpbrk (s1, s2) 

char <«s1, +82; 

int strspn (s1, $2) 

char <«s1, «$2; 

int strespn (s1, $2) 

char <«s1, «32; 

char «strtok (s1, $2) 

char «31, «$2; 
DESCRIPTION 


These functions operate on null-terminated ana They do not check for overflow of any 
receiving string. 


Strcat appends a copy of string s2 to the end of string s?. Strncat copies at most n characters. 
Both return a pointer to the null-terminated result. 





Strcmp compares its arguments and returns an integer greater than, equal to, or less than 0, 
according as s7 is lexicographically greater than, equal to, or less than s2. Sirncmp makes the 
same comparison but looks at at most n characters. , 


Strcpy copies string s2 to s?, stopping after the null character has been moved. Strncpy 
copies exactly n characters, truncating or null-padding sf; the target may not be null-terminated 
if the length of s2 is n or more. Both return s7. 





Strien returns the number of non-null characters in s. 
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BUGS 


Strchr (strrchr) returns a pointer to the first (last) occurrence of character c in string s, or NULL 
if c does not occur in the string. The null character terminating a string is considered to be part 
of the string. 


Strpbrk returns a pointer to the first occurrence in string s7 of any character from string s2, or 
NULL if no character from s2 exists in s7. 


Strspn (strcspn) returns the length of the initial segment of string s7 which consists entirely of 
characters from (not from) string s2. 


Strtok considers the string s7 to consist of a sequence of zero or more text tokens separated by 
spans of one or more characters from the separator string s2. The first call (with pointer s7 
specified) returns a pointer to the first character of the first token, and will have written a NULL 
character into s7 immediately following the returned token. Subsequent calls with zero for the 
first argument, will work through the string s7 in this way until no tokens remain. The separator 
string s2 may be different from call to call. When no token remains in s7, a NULL is returned. 


Strcmp uses native character comparison, which is signed on the Z8000, and unsigned on other 
machines. 


All string movement is performed character by character starting at the left. Thus overlapping 
moves toward the left will work as expected, but overlapping moves to the right may yield 
surprises. 
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NAME 
_ Swab - swap bytes 


SYNOPSIS 
swab (from, to, nbytes) 
char from, sto; 
int nbytes; 
DESCRIPTION 
Swab copies nbytes bytes pointed to by from to the position pointed to by fo, exchanging adja- 


cent even and odd bytes. It is useful for carrying binary data between PDP-11s and other 
machines. Nbytes should be even. 











Page 1 : March 27, 1984 


SYSTEM(3S) SYSTEM(3S) 


NAME 





system - issue a shell command 
SYNOPSIS 
#include <stdio.h> 
int system (string) 
char sstring; 
DESCRIPTION 
System causes the string to be given to sh(1) as input as if the string had been typed as a com- 
mand at a terminal. The current process waits until the shell has completed, then returns the 
exit status of the shell. | 
SEE ALSO 
sh(1), exec(2). 
DIAGNOSTICS 
System stops if it can’t execute sh(1). 








TERMLIB(3C) (Plexus) TERMLIB(3C) 


NAME 





tgetent, tgetnum, tgetflag, tgetstr, tgoto, touts - terminal independent operation routines 


SYNOPSIS 
char PC; 
char *BC; 
char *UP; 
short ospeed; 


tgetent(bp, name) 
char *bp, *name; 


tgetnum(id) 
char *id; 


tgetflag(id) 
char *id; 


char * 
tgetstr(id, area) 
char ‘id, **area; 


char * 
tgoto(cm, destcol, destline) 
char *cm; 


tputs(cp, affcnt, outc) 
register char *cp; 

int affent; 

int (“outc) (); 


DESCRIPTION 


These functions extract and use capabilities from the terminal capability data base termcap(5). 
These are low level routines. 


Tgetent extracts the entry for a terminal name into the buffer at bp. Bp should be a character 
buffer of size 1024 and must be retained through all subsequent calls to tgetnum, tgetflag, and 
tgetstr. Tgetent returns -1 if it cannot open the termcap file, 0 if the terminal name given does 
not have an entry, and 1 if all goes well. It looks in the environment for a TERMCAP variable. If 
found, and the value does not begin with a slash, and the terminal type name is the same as the 
environment string TERM, the TERMCAP string is used instead of reading the TERMCAP file. If it 
does begin with a slash, the string is used as a path name rather than /etc/termcap. This can 
speed up entry into programs that call tgetent, as well as help debug new terminal descriptions 
or make one for your terminal if you can't write the file /etc/termcap. 


Tgetnum gets the numeric value of capability id, returning -1 if id is not given for the terminal. 
Tgetflag returns 1 if the specified capability is present in the terminal's entry, 0 if it is not. 
Tgetstr gets the string value of the capability id, placing it in the buffer at area, and advancing 
the area pointer. It decodes the abbreviations for this field described in feraCe Ae), except for 
cursor addressing and padding information. 


Tgoto returns a cursor addressing string decoded from cm to go to column destcol in line dest- 
line. \t uses the external variables UP (from the up capability) and BC (if bc is given rather than 
bs) if necessary to avoid placing \n, “D, or “@ in the returned string. (Programs that call tgoto 
should turn off the XTABS bit(s), since tgoto may now output a tab. Note that programs using 
termcap should in general turn off XTABS anyway, since some terminals use control | for other 
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functions, such as nondestructive space.) If a % sequence is given that is not understood, then 
tgoto returns "OOPS". 


Tputs decodes the leading padding information of the string cp; affcnt gives the number of lines 
affected by the operation, or 1 if this is not applicable. Outc is called with each character in 
turn. The external variable ospeed should contain the output speed of the terminal as encoded 
by stty(2). The external variable PC should contain a pad character to be used (from the pe 
capability) if a null (“@) is inappropriate. 





FILES 

/usr/lib/libtermlib.a termcap library 

/etc/termcap data base 
NOTES 

These routines are based on those from the University of California at Berkeley. 
SEE ALSO 


ex(1), termcap(5). 
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NAME 

tmpfile - create a temporary file 
SYNOPSIS 

#include <stdio.h> 

FILE stmpfile () 


DESCRIPTION 
Tmpfile creates a temporary file and returns a corresponding FILE pointer. Arrangements are 
made so that the file will automatically be deleted when the process using it terminates. The file 
is opened for update. 

SEE ALSO 
creat(2), unlink(2), fopen(3S), mktemp(3C), tmpnam(3S). 
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NAME 
tmpnam - create a name for a temporary file - 

SYNOPSIS 
#inciude <stdio.h> 
char «tmpnam (s) 
char 3; 

DESCRIPTION 
Tmpnam generates a file name that can safely be used for a temporary file. If (int)s is zero, 
tmpnam leaves its result in an internal static area and returns a pointer to that area. The next 
call to tmpnam will destroy the contents of the area. If (int)s is nonzero, s is assumed to be the 
address of an array of at least L_tmpnam bytes; tmpnam places its result in that array and 
returns Ss as its value. 
Tmpnam generates a different file name each time it is called. 
Files created using tmpnam and either fopen or creat are only temporary in the sense that they 
reside in a directory intended for temporary use, and their names are unique. It is the user's 
responsibility to use unlink (2) to remove the file when its use is ended. 

SEE ALSO 

— creat(2), unlink(2), fopen(3S), mktemp(3C). 

BUGS | | 
lf called more than 17,576 times in a single process, tmpnam will start recycling previously used 
names. 
Between the time a file name is created and the file is opened, it is possible for some other pro- 
cess to create a file with the same name. This can never happen if that other process is using 
tmpnam or mktemp, and the file names are chosen so as to render duplication by other means 
unlikely. 
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NAME 
sin, Cos, tan, asin, acos, atan, atan2 - trigonometric functions 


SYNOPSIS | 
#include <math.h> 


double sin (x) 
double x; 


double cos (x) 
double x; 


double asin (x) 
double x; 


double acos (x) 
double x; 


double atan (x) 
double x; 


double atan2 (y, x) 
double x, y; 


DESCRIPTION 
Sin, cos and tan return trigonometric functions of radian arguments. The magnitude of the 
argument should be checked by the caller to make sure the result is meaningful. 


Asin returns the arc sin in the range -2/2 to 2/2. 
Acos returns the arc cosine in the range 0 to a. 
Atan returns the arc tangent of x in the range -7/2 to 1/2. 
Atan2 returns the arc tangent of y/x in the range -7 to a. 


DIAGNOSTICS 
Arguments of magnitude greater than 1 cause asin and acos to return value 0. 
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NAME 
ttyname, isatty, ttyslot - find name of a terminal 


SYNOPSIS 
char «ttyname (fildes) 


int isatty (fildes) 
ttyslot() 


DESCRIPTION 
Ttyname returns a pointer to the null-terminated path name of the terminal device associated 
with file descriptor fildes. 


lsatty returns 1 if fildes is associated with a terminal device, 0 otherwise. Ttys/ot returns the 
number of the slot in /etc/utmp corresponding to the current user. 


FILES 
/dev/* 
/etc/utmp 


DIAGNOSTICS 
Ttyname returns a null pointer (0) if fildes does not describe a terminal device in directory /dev. 


Ttyslot returns -1 if /etc/utmp is inaccessible or if it cannot determine the control terminal. 


BUGS 
The return value points to static data whose content is overwritten by each call. 
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NAME 
ungetc - push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


int ungetc (c, stream) 
char c; 
FILE «stream; 


DESCRIPTION 
Ungetc pushes the character c back on an input stream. That character will be returned by the 
next getc call on that stream. Ungetc returns c. 


One character of pushback is guaranteed provided something has been read from the stream 
and the stream is actually buffered. Attempts to push EOF are rejected. 


Fseek(3S) erases all memory of pushed back characters. 


SEE ALSO 
fseek(3S), getc(3S), setbuf(3S). 


DIAGNOSTICS 
Ungetc returns EOF if it can't push a character back. 
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NAME 





intro - introduction to special files 


DESCRIPTION 
This section describes various special files that refer to specific Plexus: peripherals and UNIX 
device drivers. The names of the entries are generally derived from Plexus names for the 
hardware, as opposed to the names of the special files themselves. Characteristics of both the 
hardware device and the corresponding UNIX device driver are discussed where applicable. 


NOTES 
Plexus does not support some devices because of hardware differences between DEC and 
Plexus machines. The following devices are not supported: cat, dj, dmc, dn, dqs, du, dz, hp, 
hs, ht, kl, kmc, pel, rf, rk, rl, rp, tm, and vp. Plexus adds the following: dk, icp, is, mt, pd, pp, 
pt, and rm. 


BUGS 
The names of the entries generally refer to Plexus hardware names, but in certain cases these 
names are arbitrary for various historical reasons. 
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NAME 
dk - pseudo disk driver 


DESCRIPTION | 
Dk is the "generic" disk device. It accesses whatever disk you have; it tries IMSC disks first. If 
you have both IMSC and iSBC disks, you must use the special file is to access the iSBC disk. 


FILES 
/dev/dk? 


NOTES 
_ This is a Plexus feature. It is not part of stock SYSTEM Ill. 
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NAME 
err - error-logging interface 

DESCRIPTION 
Minor device 0 of the err driver is the interface between a process and the system’s error- 
record collection routines. The driver may be opened only for reading by a single process with 
super-user permissions. Each read causes an entire error record to be retrieved; the record is 
truncated if the read request is for less than the record's length. 


FILES 
/dev/error special file 


SEE ALSO 
errdemon(1M). 
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NAME 





icp - Intelligent Communications Processor 


‘DESCRIPTION | 
The icp is a special device that allows access to the memory of the Intelligent Communications 
Processor (ICP). Reading from the device resets the ICP. Writing to the device overwrites the 
memory. 
FILES 
/deviic{0-4] 


BUGS 
| Reading from the ICP resets it and kills all terminals actively using it. 


SEE ALSO 
dnid(1m) 
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NAME 
imsp - Intelligent Mass Storage Processor 

DESCRIPTION 
The imsp is a special device that allows access to the memory of the Intelligent Mass Storage 
processor (IMSP). Reading from the device returns data from the IMSP's local memory. Writ- 
ing to the device overwrites the IMSP’s local memory. 

FILES 
/dev/im[0-3] 

WARNING 
Writing to the IMSP can cause it to hang. This may crash UNIX and destroy file systems. 


IS(4) (Plexus) — 18(4) 


NAME 





is - iSBC disk controller 


DESCRIPTION 
The iSBC disk controller and associated driver code access up to 4 disks. Each disk is subdi- 
vided into 16 logical volumes. By convention, /dev/dk[0-15] refer to the logical volumes of disk 
0, /dev/dk[16-31] refer to the logical volumes of disk 1, and so on. 


The origin and size of the 16 logical volumes on a disk are: 


Volume Starting Block Length (in 1024 byte blocks) 
(1024 byte) (~ refers to end of disk) 


o.060OC«OOD 

1 0 20000 
2 20000 . 
3 30000 . 
4 40000 7 
5 50000 . 
6 60000 . 
7 70000 ~ 
8 80000 ‘i 
9 90000 * 
10 100000 . 
11 110000 = 
12 120000 . 
13 130000 . 
14 140000 - 
15 150000 ‘i 





The dk files access the disk via the system’s normal buffering mechanism and may be read and 
written without regard to physical disk records. There is also a ‘raw’ interface which provides for 
direct transmission between the disk and the user's read or write buffer. A single read or write 
Call results in exactly one I/O operation and therefore raw |/O is considerably more efficient 
when many words are transmitted. The names of the raw is files begin with rdk and end with a 
number that selects the same logical disk volume as the corresponding dk file. 


In raw 1/O the buffer must begin on a word boundary. 


FILES 
/dev/dk? 


BUGS | 
in raw I/O read and write(2) truncate file offsets to 1024-byte block boundaries, and write scrib- 
bles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, 
read, write and lseek(2) should always deal in 1024-byte multiples. 
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NAME 





Ip - line printer 
DESCRIPTION 
The fine printer is a special file to which the line printer daemon, /pd, prints output. It may be a 
serial port, ttyX, or a parallel port, ppX. 
FILES 
/devitp 
SEE ALSO 
Ipr(1), tty(4) pp(4). 
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NAME 





mem, kmem - core memory 
mbiomem, mbmem - Multibus memory 
liomem - local I/O device memory 


DESCRIPTION | | 
Mem is a special file that is an image of the core memory of the computer. It may be used, for 
example, to examine, and even to patch the system. 


Byte addresses in mem are interpreted as memory addresses. References to non-existent 
locations cause errors to be returned. 


Examining and patching device registers is likely to lead to unexpected results when read-only 
or write-only bits are present. 


The file kmem is the same as mem except that kernel virtual memory rather than physical 
memory is accessed. 


Mbiomem is a special file that is an image of the Multibus I/O address space. 
Mbmem is a special file that is an image of the Multibus memory address space. 


Liomem is a special file that ia an image of the local I/O device address space. This can be 
used, for example, to reference the clock chip or the SIO chip. 


FILES 
| /dev/mem 
/dev/kmem 
/dev/mbiomem 
/dev/momem 
/devitiomem 
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NAME 
mt - pseudo tape driver 


DESCRIPTION | : 
Mt is the "generic" tape device. It accesses whatever tape you have -- either 9-track or car- 
tridge. If you have both 9-track and cartridge tapes, mt accesses the 9-track, and you may use 
the special file pt to access the cartridge tape or else omit the device specification entirely. 


FILES 
/dev/mt? 


NOTES 
This is a Plexus feature. It is not part of stock SYSTEM III. 
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NULL(4) 
NAME 

null - the null file 
DESCRIPTION 


Data written on a null special file is discarded. 


Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 
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NAME 
mt - pseudo tape driver 


DESCRIPTION 
Mt is the "generic" tape device. It accesses whatever tape you have -- either 9-track or car- 
tridge. If you have both 9-track and cartridge tapes, pt accesses the 9-track, and you may use 
' the special file mt to access the cartridge tape or else omit the device specification entirely. 


FILES 
/dev/mt? 


NOTES 
This is a Plexus feature. It is not part of stock SYSTEM Ill. 
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NAME 





pd - IMSP disk controller 


DESCRIPTION 
The IMSP disk/tape controller and associated driver code access up to 4 disks. Each disk is 
subdivided into 16 logical volumes. By convention, /dev/dk[0-15] refer to the logical volumes of 
physical disk 0, /dev/dk[16-31] refer to the logical volumes of physical disk 1, and so on. 


The origin and size of the 16 logical volumes on a disk are as follows. ‘’ refers to the end of 
the physical disk. Length is given in 1024 byte blocks. 





Volume Starting Block Length 

0 0 is 

1 0 20000 (default swap area 
is 18000-20000) 

2 20000 

3 30000 

4 40000 ~ 

5 50000 J 

6 60000 — 

7 70000 . 

8 80000 * 

9 90000 ‘ 

10 100000 ~ 

11 110000 ~ 

12 120000 “ 

13 130000 is 

14 140000 . 

15 150000 e 


The dk files access the disk via the system’s normal buffering mechanism and may be read and 
written without regard to physical disk records. There is also a ‘raw’ interface which provides for 
direct transmission between the disk and the user's read or write buffer. A single read or write 
call results in exactly one !/O operation and therefore raw I/O is considerably more efficient 
when many words are transmitted. The names of the raw pd files begin with rdk and end with 
a number that selects the same logical disk volume as the corresponding ok file. 


In raw I/O the buffer must begin on a word boundary. 


FILES 
/dev/dkx 


NOTES 
This is a Plexus device, not part of standard SYSTEM Ill. 


DIAGNOSTICS 
The IMSP controller may produce the following error messages: 


0x0201 Reserved for controller busy 
0x0301 Command undefined 
0x0401 Command cannot be done 
0x0501 Bad CAB parameters 
Ox0f01 Firmware bug encountered 
0x0601 = Internal command interrupts 





Page 1 April 4, 1984 











PD(4) 


0x0701 
0x0801 
0x1103 
0x1203 


0x1303 


0x1403 
0x1503 
0x1603 
0x1703 
0x1803 
0x1903 
0x1b03 
Ox1c03 
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Parity error occurred 
PROM checksum error 
Disk protected from writing 
Disk not ready 

Disk drive fault indicated 
Disk failed to select 

Disk operation timeout error 
Disk failed in formatting 
Disk seek error 

Disk ECC error in id field 
Disk ECC error in data field 
Disk limits not defined 

Disk unable to locate track 


PD(4) 


Page 2 


PP(4) (Plexus) PP(4) 


NAME 
pp - parallel. port interface 

DESCRIPTION 
The parallel port interface enables access to the parallel port on the Intelligent Communications 
Processor (ICP). Each ICP has one parallel port interface. The parallel port interface is a 
write-only device. It is also a raw device, i.e., the operating system does no processing of data 
written to it. 


Pp has no stty-like features. If your printer does not handle tabs and new-line characters, you 
need to write a filter to use this device. 


FILES 
/dev/pp[0-3] 


SEE ALSO 
Ip(4), tty(4), icp(4) 
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NAME 





prf - operating system profiler 

DESCRIPTION 
The file prf provides access to activity information in the operating system. Writing the file 
loads the measurement facility with text addresses to be monitored. Reading the file returns 
these addresses and a set of counters indicative of activity between adjacent text addresses. 


The recording mechanism is driven by the system clock and samples the program counter at 
line frequency. Samples that catch the operating system are matched against the stored text 
addresses and increment corresponding counters for later processing. 

The file prf is a pseudo-device with no associated hardware. 


FILES 
/dev/prt 


SEE ALSO 
config(1M), profiler(1M). 
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NAME 


(Plexus) PT(4) 


pt - IMSP cartridge controller 


DESCRIPTION 
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The IMSP disk/tape controller and associated driver code allow access to a cartridge tape. The 
cartridge can be accessed only in raw mode (i.e., as a character device), and can be rewound 
or left at the current position. These options are available based on the minor device number of 
the special file used to access it. If the cartridge is not to be rewound, it is positioned after the 
filemark at the end of the current file. 


If the 04 bit is on in the minor device number, the cartridge is not rewound when closed. 


By convention, the files /dev/rmt0 and /dev/nrmt0 are used to access the cartridge in raw 
mode. Accessing /dev/rmt0 rewinds the cartridge when this special file is closed. Accessing 


/dev/nrmt0 does not rewind the cartridge when the file is closed. Each read or write call reads 


or writes the next record on the cartridge. All records on a cartridge are 512 bytes long and all 
reads and writes must be in multiples of 512 bytes. An error is returned otherwise. The I/O 
buffer used in the read(2) or write(2) system call should begin on a word boundary and the 
count should be even. Seeks are ignored. A zero byte count is returned when a file mark is 
read, but another read will fetch the first record of the new file. 


The cartridge drive can be accessed in high speed mode. However, this mode is effectively lim- 
ited to skipping forward over files on the cartridge and to I/O between the cartridge and a disk 
attached to the same IMSP controller. High speed mode is accessed via iocti(2) system calls. 
The arguments to the /oct/ are: 


fildes File descriptor returned from an open(2) of the special tape file /dev/rmtOor 
/dev/nrmto. 


request A special command for the cartridge drive. These commands are defined in 


. /usr/include/sys/imsc.h and some are described below. 
arg A pointer to a structure of the type "ptcmd" as defined in /usr/include/sys/imsc.h. 
Some of the members of ptemd are: 


dknum _ Major/minor device number of the IMSP disk being read or written to (if applicable) 
as returned by stat(2) system call (st_rdev). 


bikno Starting sector number on logical disk to be read/written. Sectors on disk are 512 
bytes long and numbered starting at 0. Note sector addresses are relative to the log- 
ical, not the physical disk. 


bikent The number of 512-byte records to be read from or written to cartridge. 


Some of the more useful joctih requests for the cartridge as defined in 
/usr/include/sys/imsc.h are: 


C_IRECALL Read from cartridge and write to disk. The cartridge and disk must be on same 
IMSP controller. The system returns in ptemd.bikent the number of 512-byte 
records not read. This is zero if the system reads all the records requested. 


C_ISAVE Read from disk and write to tape. The cartridge and disk must be on same IMSP 
controller. The system returns in ptemd.bikent the number of 512-byte records 
not read. This is zero if the system reads all the record images (sectors) 
requested. ; 


C_IWEOF Write EOF mark on cartridge. 
C_IREW Rewinds the cartridge. 
C_IMOVE Position to file blkent on cartridge. 
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Writing multiple files on cartridge should be done all at once, i.e., without rewinding the car- 
tridge. Once a cartridge has been rewound, positioning to the end of a file on the cartridge and 
then writing to the cartridge may overwrite data. For example, once the cartridge has been 
rewound, positioning to the end of file 2 and writing to the cartridge may overwrite portions of 








file 2. 
Neither the hardware or the software implement or support an end-of-tape marker on the car- 
tridge. 
FILES 
/dev/rmtO 
/dev/nrmtO 
DIAGNOSTICS 
The IMSP controller may produce the following error diagnostics: . 
0x0201 + Reserved for controller busy 
0x0301 © Command undefined 
0x0401 § Command cannot be done 
0x0501 Bad CAB parameters 
Ox0f01 Firmware bug encountered 
0x0601 = Internal command interrupts 
0x0701 Parity error occurred 
0x0801 § PROM checksum error 
0x1004 End of file reached 
0x1304 An exception other than an end-of-file error 
0x1504 Tape timeout error 
0x1604 = Error during recall 
0x1704 Error during save 
0x1804 = Error received while attempting to get status from the tape drive 
0x1804 During exception state, a command other than rstat was received 
0x2004 No tape drive present 
0x2104 Timeout during wait recall 
0x2204 Timeout during wait save 
0x2304 Timeout during stat tape 
0x2404 Timeout during stat tape 
0x2504 Timeout during command tape 
0x2604 Timeout during command tape 
0x2704 Timeout during ready tape 
0x2804 Tape drive inconsistent at start of tape command 
0x1505 § Timeout on Host bus request 
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NAME 


(Plexus) | RM(4) 


tm - Cipher Microstreamer tape drive 


DESCRIPTION 


FILES 


The Cipher Microstreamer magnetic tape can be accessed in blocked or raw mode and can be 
rewound or left at the current position. These options are available based on the minor device 
number of the: special file used to access it. When the special file is closed, the tape can be 
rewound or not (see below). If the special file was open for writing, two end-of-files are written. 
if the tape is not to be rewound, it is positioned with the head between the two tapemarks. 


if the 04 bit is on in the minor device number, the tape is not rewound when closed. 


If the 010 bit is on in the minor device number, the tape is set to high speed mode (100 in/sec). 
By convention, /dev/nrrmh0 accesses the tape in high speed mode. 


By convention, the file /dev/mt0 accesses the tape in blocked mode. A tape accessed in block 
mode consists of a series of 1024-byte records terminated by an end-of-file. As much as it 
can, the system makes it possible, if inefficient, to treat the tape like any other file. Seeks have 
their usual meaning and it is possible to read or write a byte at a time. Writing in very small 
units is inadvisable, however, because it tends to create monstrous record gaps. 


Use /dev/mt0 to access the tape in a way compatible with ordinary files. However, when 
foreign tapes are to be dealt with, and especially when long records are to be read or written, 
the ‘raw’ interface is more appropriate. By convention, the files /dev/rmt0 and /dev/nrmt0O are 
used to access the tape in raw mode. Accessing /dev/rmt0 rewinds the tape when /dev/rmtd is 
closed. Accessing /dev/nrmt0 does not rewind the tape when /dev/nrmtod is closed. 


Each read or write call reads or writes the next record on the tape. For writes, the record has 
the same length as the buffer given. During a read, the record size is passed back as the 
number of bytes read, provided it is no greater than the number of bytes requested; if the record 
is longer than the number of bytes requested, an error is returned. On the other hand, if the 
number of bytes requested is larger than the actual record size, there is a delay of 1-2 seconds 
between the reading of each record. 


In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. A zero byte count is returned when a tape mark is read, but another read will fetch 
the first record of the new tape file. 


The tape drive can be run in high speed mode; however, this is really only usable for fast for- 
ward or reverse skipping of file marks. The files used for high speed mode are denoted by an ‘h’ 
just before the unit number. ) 


There is an ioctl(2) interface for controlling the tape drive. More information about this can be 
found in /usr/include/sys/rm.h. 


/dev/mt0 
/dev/rmtO 
/dev/nrmtO 
/dev/nrrmhO 


SEE ALSO 


tape(1). 


DIAGNOSTICS 
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The tape controller issues the following codes for unrecoverable errors detected during execu- 
tion of a command. The code is returned in the Command Status vie: bits 0-4. 


Code Description 
00 No unrecoverable error. 
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NAME 


(Plexus) RM(4) 


rm — Cipher Microstreamer tape drive 


DESCRIPTION 
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The Cipher Microstreamer magnetic tape can be accessed in blocked or raw mode and can be 
rewound or left at the current position. These options are available based on the minor device 
number of the special file used to access it. When the special file is closed, the tape can be 
rewound or not (see below). If the special file was open for writing, two end-of-files are written. 
If the tape is not to be rewound, it is positioned with the head between the two tapemarks. 


If the 04 bit is on in the minor device number, the tape is not rewound when closed. 


If the 010 bit is on in the minor device number, the tape is set to high speed mode (100 insec). 
By convention, /dev/nrrmhO accesses the tape in high speed mode. 


By convention, the file /dev/mt0 accesses the tape in blocked mode. A tape accessed in block 
mode consists of a series of 1024-byte records terminated by an end-of-file. As much as it can, 
the system makes it possible, if inefficient, to treat the tape like any other file. Seeks have their 
usual meaning and it is possible to read or write a byte at a time. Writing in very small units is 
inadvisable, however, because it tends to create monstrous record gaps. 


Use /dev/mt0 to access the tape in a way compatible with ordinary files. However, when foreign 
tapes are to be deait with, and especially when long records are to be read or written, the ‘raw’ 
interface is more appropriate. By convention, the files /dev/rmtO and /dev/nrmtO are used to 
access the tape in raw mode. Accessing ‘dev/rmt0 rewinds the tape when /dev/rmt0 is closed. 
Accessing /dev/nrmt0 does not rewind the tape when /dev/nrmto0 is closed. 


Each read or write call reads or writes the next record on the tape. For writes, the record has 
the same length as the buffer given. During a read, the record size is passed back as the 
number of bytes read, provided it is no greater than the number of bytes requested; if the record 
is longer than the number of bytes requested, an error is returned. On the other hand, if the 
number of bytes requested is larger than the actual record size, there is a delay of 1-2 seconds 
between the reading of each record. 


In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. A zero byte count is returned when a tape mark is read, but another read will fetch 
the first record of the new tape file. 


The tape drive can be run in high speed mode; however, this is really only usable for fast for- 
ward or reverse skipping of file marks. The files used for high speed mode are denoted by an ‘h’ 
just before the unit number. 


If you want to write your own program for tape manipulation on the rm device, there is an 
loctl(2) interface for controlling the tape drive. The file /usr/include/sys/rm.h lists the commands 
that can be issued. These all begin with “C_” (capital C followed by an underbar). The only 
ioctl request type allowed for this device is RMPOSN (“rm position”). The ioctl call structure is 


struct rmcmd_struct { 
unsigned rm_cmd; /* the command C_<option> */ 
unsigned rm_cnt; /“ count, useful for commands such as SRCHEOF *’ 
unsigned rm_status; /“ physical device status returned */ 


July 26, 1984 


RM(4) (Plexus) RM(4) 





The status value is found by adding all the relevant values in the “status fields” portion of rm.h. 
Status is determined by the output status field, which consists of two bytes arranged as follows: 


15 14 #13 12 #1110 98 7 6 5 4 3 2 1 
a oe ee ioe. CU 
| E | c | R | ERROR |.FM | OL | LP | EOT | R | FB | P | 
eres, fee Peete eres Seen ees (oer eee eee | eee coe eee are 
where 
Byte 0 Not used 
P (Write Protect) The tape does not have a write enable ring. 


(Formatter Busy) The Formatter is busy. 
(Ready) The selected drive is ready. 
(End of Tape) The EOT marker was detected. 
(Load Point) The tape is at load point. 
OL (On Line) The drive is on line. 
(Filemark) A filemark was detected on this operation. 
(Entered) Execution has begun. 
(Complete) The command has completed successfully. 
R (Retry) At least one Retry was executed . 
ERROR This 5-bit field specifies an error code when a non-recoverable error 
is encountered. Error codes are listed under DIAGNOSTICS below. 


For example, the value “C068” means the tape is online at load point, ready, and previous com- 
mand has completed. 





The following program fragment illustrates the use of ioctl to rewind the tape. 


#include “sys/rm.h" 
#include “fentl.h” 
int fildes; i" file descriptor, returned by open */ 


fildes = open("/dev/rmt0",O_RDWR); 


rmcmd.cmd = C_REW;: 
rmcmd.cnt = 1; 
rmcmd.status = -1; 


locti(fildes, RMPOSN, &rmcma); 


FILES 
idev/mt0 
/dev/rmt0 
idev/nrmtO 
‘dev/nrrmh0 
/usr/include/sys/rm.h 


SEE ALSO 
tape(1), iocti(2). 


DIAGNOSTICS 
The tape controller issues the following codes for unrecoverable errors detected during execu- 
tion of acommand. The code is returned in the Command Status byte, bits 8-12. 
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Code Description 


00 
01 
02 
03 
04 
05 
06 
07 
08 
09 


OA 
OB 


0c 
0D 
OE 
OF 


10 
11 
12 
13 


14 
15 
16 


17 
18 
19 


No unrecoverable error. 

Timed out waiting for expected Data Busy false. 

Timed out waiting for expected Data Busy false, Formatter Busy false and Ready True. 
Timed out waiting for expected Ready false. 

Timed out waiting for expected Ready true. 

Timed out waiting for expected Data Busy true. 

A memory time-out occurred during a system memory reference. 

A blank tape was encountered where data was expected. 

An error occurred in the micro-diagnostic. 


An unexpected EOT was encountered during a forward operation, or Load Point during a 
reverse operation. 


A hard or soft error occurred that could not be eliminated by retry. 


A read overflow or write overflow occurred. This error indicates that the FIFO was empty 
when data was requested by the tape during a write, or full when the tape presented a 
byte during a read. 


Not used. 
A read parity error occurred on the byte interface between the drive and the controller. 
An error was detected during calculation of the checksum on the PROM. 


A tape time-out occurred, because the tape drive did not supply an expected read or write 
strobe. This error occurs when you attempt to read a larger record than was written. It 
may also occur during a write if the tape is damaged. 


Tape not ready. 
A write was attempted on a tape without a write-enable ring. 
Not used. 


The diagnostic mode jumper was not installed while attempting to execute a Diagnostic 
command. 


An attempt was made to link from a command that does not allow linking. 
An unexpected filemark was encountered during a tape read. 


An error in specifying a parameter was detected by the controller. The usual cause is a 
byte count that is either zero or too large. 


Not used. 
An unidentifiable hardware error occurred. 


A streaming read or write operation was terminated by the operating system or disk. 


The tape driver sends the code FFFF to the screen when the block size requested is smaller 
than the actual block size on the tape. 
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01 


aSEEBR 


06 
07 
08 
09 


0A 
0B 


oc 
0D 
OE 
OF 


10 
11 
12 
13 


14 
15 
16 


17 
18 
19 
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Timed out waiting for expected Data Busy false. 

Timed out waiting for expected Data Busy false, Formatter Busy false and Ready True. 
Timed out waiting for expected Ready false. 

Timed out waiting for expected Ready true. 

Timed out waiting for expected Data Busy true. 

A memory time-out occurred during a system memory reference. 

A blank tape was encountered where data was expected. 

An error occurred in the micro-diagnostic. | 


An unexpected EOT was encountered during a forward operation, or Load Point during a 
reverse operation. 


A hard or soft error occurred that could not be eliminated by retry. 


A read overflow or write overflow occurred. This error indicates that the FIFO was empty 
when data was requested by the tape during a write, or full when the tape presented a 
byte during a read. 


Not used. 
A read parity error occurred on the byte interface between the drive and the controller. 
An error was detected during calculation of the checksum on the PROM. 


A tape time-out occurred, because the tape drive did not supply an expected read or 
write strobe. This error occurs when you attempt to read a larger record than was writ- 
ten. It may also occur during a write if the tape is damaged. 


Tape not ready. | 
A write was attempted on a tape without a write-enable ring. 
Not used. 


The diagnostic mode jumper was not installed while attempting to execute a Diagnostic 
command. 


An attempt was made to link from a command that does not allow linking. 
An unexpected filemark was encountered during a tape read. 


An error in specifying a parameter was detected by the controller. The usual cause is a 
byte count that is either zero or too large. 


Not used. 
An unidentifiable hardware error occurred. 
A streaming read or write operation was terminated by the operating system or disk. 


The tape driver sends the code FFFF to the screen when the block size requested is smaller 
than the actual block size on the tape. 
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NAME 
st - synchronous terminal interface 

DESCRIPTION | 
The synchronous terminal interface is a pseudo-device driver that enables a UNIX system to 
communicate with a TELETYPE® Model 40/4 ASCII synchronous terminal. The driver utilizes the 
Virtual Protocol Machine (VPM) to perform the end-to-end protocol and transmission assurance 
for the synchronous line. 
The user must be familiar with the operation of the Model 40/4 terminal. Screen management 
functions are completely controlled by the user process; when formating a screen, the user must 
supply everything from the initial STX (Start-of-Text) character to the ETX (End-of-Text) charac- 
ter. 
By convention, /dev/st0 is the synchronous terminal control channel, while other /dev/st? files 
represent user terminal channels. Communication with the control channel is handled by the 
stcntrl command (see st(1M)). 
A user process will sleep when trying to open a channel, until a terminal requests service. At 
that time, a channel will be assigned to that terminal, and it will remain allocated until the user 
process closes the terminal. 
In addition to the synchronous terminal equipment, a KMC11-B microprocessor, and a DMC11- 
DA synchronous line unit are required. 

FILES 
/etc/stproto synchronous terminal prototype script 
/dev/kmc? KMC11-B microprocessor 
/dev/vpm? virtual protocol machine 
/dev/stO synchronous terminal control channel 
/dev/st? synchronous terminal user channels 

SEE ALSO 
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st(1M), kmc(4), trace(4), vpm(4). 
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NAME 
swap - image of the swap area 


DESCRIPTION 
Swap is a block special device that corresponds to the file system containing the swap area 
(default /dev/dk1). Reading from the swap device returns data from the swap area. 


FILES 
/dev/swap 
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NAME 


trace - event-tracing driver 


DESCRIPTION 


Trace is a special file that allows UNIX kernel drivers to transfer event records to a user pro- 
gram, so that the activity of the driver may be monitored for debugging purposes. 


An event record is generated from within a kernel driver by executing the following function: 


trsave(dev, chno, buf, cnt) 
char dev, chno, «buf, cnt; 


Dev is the minor device number of the trace driver; chno is an integer between 1 and 16, 
inclusive, identifying the data stream to which the record belongs; buf is a buffer containing the 
bytes that make up a single event record; and cnt is the number of bytes in buf. Calls to trsave 
will result in data being saved in a clist buffer, provided that some user program has opened the 
trace minor device number dev and has activated channel chno. Event records prefaced by 
chno and cnt are stored in a clist queue until a system-defined maximum (TRQMAX) is reached; 
event records are discarded while the queue is full. The clist queue is emptied by a user pro- 
gram reading the trace driver. The trace driver returns an integral number of event records; the 


~ read count must, therefore, be at least equal to the size of a record plus two, to allow for the 


chno and cnt bytes added to the event record by the trsave routine. 


The trace driver supports open, close, read, and ioctl system calls. To activate a channel, ioctl 
is used as follows: 


#include <ioctl.h> 
iocti(fildes, VPMTRCO, chno) 


SEE ALSO 
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vomstart(1C), vpm(4). 
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NAME 
tty - general terminal interface 
DESCRIPTION 


This section describes both a particular special file and the general nature of the terminal inter- 
face. 





The file /dev/tty is, in each process, a synonym for the control terminal associated with the pro- 
cess group of that process, if any. It is useful for programs or shell sequences that wish to be 
sure of writing messages on the terminal no matter how output has been redirected. It can also 
be used for programs that demand the name of a file for output, when typed output is desired 

and it is tiresome to find out what terminal is currently in use. | 


As for terminals in general: all of the asynchronous communications ports use the same general 
interface, no matter what hardware is involved. The remainder of this section discusses the 
common features of this interface. 


When a terminal file is opened, it normally causes the process to wait until a connection is esta- 
blished. In practice, users’ programs seldom open these files; they are opened by getty(8) and 
become a user's standard input, output, and error files. The very first terminal file opened by 
the process group leader of a terminal file not already associated with a process group becomes 
the contro! terminal for that process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal is inherited by a child pro- 
cess during a fork(2). A process can break this association by changing its process group using 
setpgrp(2). 


A terminal associated with one of these files ordinarily operates in full-duplex mode. Characters 
may be typed at any time, even while output is occurring, and are only lost when the system's 
character input buffers become completely full, which is rare, or when the user has accumulated 
the maximum allowed number of input characters that have not yet been read by some program. 
Currently, this limit is 512 characters. When the input limit is reached, all the saved characters 
are thrown away without notice. 





Normally, terminal input is processed in units of lines. A line is delimited by a new-line (ASCII 
LF) character, an end-of-file (ASCII EOT) character, or an end-of-line character. This means 
that a program attempting to read will be suspended until an entire line has been typed. Also, 
no matter how many characters are requested in the read call, at most one line will be returned. 
It is not, however, necessary to read a whole line at once; any number of characters may be 
requested in a read, even one, without losing information. 


During input, erase and kill processing is normally done. By default, the character # erases the 
last character typed, except that it will not erase beyond the beginning of the line. By default, 
the character @ kills (deletes) the entire input line, and optionally outputs a new-line character. 
Both these characters operate on a key-stroke basis, independently of any backspacing or tab- 
bing that may have been done. Both the erase and kill characters may be entered literally by 
preceding them with the escape character (\). In this case the escape character is not read. 
The erase and kill characters may be changed. 


Certain characters have special functions on input. These functions and their default character 
values are summarized as follows: 


INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent to all processes with 
the associated control terminal. Normally, each such process is forced to terminate, 
but arrangements may be made either to ignore the signal or to receive a trap to an 
agreed-upon location; see signal(2). 


QUIT (Controi-| or ASCII FS) generates a quit signal. Its treatment is identical to the inter- 
rupt signal except that, unless a receiving process has made other arrangements, it 
will not only be terminated but a core image file (called core) will be created in the 
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current working directory. 


ERASE (+#) erases the preceding character. It will not erase beyond the start of a line, as del- 
imited by a NL, EOF, or EOL character. 


KILL §  (@) deletes the entire line, as delimited by a NL, EOF, or EOL character. 


EOF (Control-d or ASCIi EOT) may be used to generate an end-of-file from a terminal. 
When received, all the characters waiting to be read are immediately passed to the 
program, without waiting for a new-line, and the EOF is discarded. Thus, if there are 
no characters waiting, which is to say the EOF occurred at the beginning of a line, zero 
characters will be passed back, which is the standard end-of-file indication. 


NL (ASCII LF) is the normal line delimiter. It can not be changed or escaped. 
EOL (ASCII NUL) is an additional line delimiter, like NL. It is not normally used. 


STOP (Control-s or ASCII DC3) can be used to temporarily suspend output. It is useful with 
CRT terminals to prevent output from disappearing before it can be read. While output 
is suspended, STOP characters are ignored and not read. 


START (Control-q or ASCIl DC1) is used to resume output which has been suspended by a 
STOP character. While output is not suspended, START characters are ignored and not 
fead. The start/stop characters can not be changed or escaped. 


The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be changed to suit indivi- 
dual tastes. The ERASE, KILL, and EOF characters may be escaped by a preceding \ character, 
in which case no special function is done. 


When the carrier signal from the data-set drops, a hangup signal is sent to all processes that 
have this terminal as the control terminal. Unless other arrangements have been made, this sig- 
nal causes the processes to terminate. If the hangup signal is ignored, any subsequent read 
returns with an end-of-file indication. Thus programs that read a termina and test for end-of- 
file can terminate appropriately when hung up on. 


When one or more characters are written, they are transmitted to the terminal as soon as 
previously-written characters have finished typing. Input characters are echoed by putting them 
in the output queue as they arrive. If a process produces characters more rapidly than they can 
be typed, it will be suspended when its output queue exceeds some limit. When the queue has 
drained down to some threshold, the program is resumed. 


‘Several ioct/(2) system calls apply to terminal files. The primary calls use the following s struc- 


ture, defined in <termio.h>: 


#define NCC 8 

struct _termio { 
unsigned short  c_iflag; /*« input modes +/ 
unsigned short  c_oflag; /x Output modes +/ 


unsigned short  c_cflag; /x control modes +/ 
unsigned short  c_lflag; /x local modes +/ 
char C_line; /x line discipline «/ 


unsigned char  c_cc[NCC]; /« control chars +/ 
}: 
The special control characters are defined by the array c_cc. The relative positions and initial 
values for each function are as follows: 


QO INTR DEL 
1 quit Fs 
2 ERASE # 
3 KILL e 
4 EOF EOT 
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5 EOL NUL 
6 reserved 
7 reserved 


The c_iflag field describes the basic terminal input control: 


IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 
PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map upper-case to lower-case on input. 
IXON 0002000 Enable start/stop output control. 

IXANY 0004000 Enable any character to restart output. 
IXOFF 0010000 Enable start/stop input control. 


See NOTES below for Plexus additions to this list. 


If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, 
that is, not put on the input queue and therefore not read by any process. Otherwise if BRKINT 
is set, the break condition will generate an interrupt signal and flush both the input and output 
queues. If IGNPAR is set, characters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not ignored is read as the 
three character sequence: 0377, 0, X, where X is the data of the character received in error. To 
avoid ambiguity in this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. 
lf PARMRK is not set, a framing or parity error which is not ignored is read as the character NUL 


(0). 


If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is dis- 
abled. This allows output parity generation without input parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are pro- 
cessed. 


If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a 
received CR character is ignored (not read). Otherwise if ICRNL is set, a received CR character 
is translated into a NL character. 


If \UCLC is set, a received upper-case alphabetic character is translated into the corresponding 
lower-case character. 


If IXON is set, start/stop output control is enabled. A received STOP character will suspend out- 
put and a received START character will restart output. All start/stop characters are ignored and 
not read. If IXANY is set, any input character will restart output that has been suspended. Note 
that some terminals experience difficulty with IXANY. 


If IXOFF is set, the system will transmit START/STOP characters when the input queue is nearly 
empty/full. 


The initial input control value is all bits clear. 
The c_oflag field specifies the system treatment of output: 








OPOST 0000001 Postprocess output. 

OLCUC 0000002 Map lower case to upper on output. 
ONLCR 0000004 Map NL to CR-NL on output. 
OCRNL 0000010 Map CR to NL on output. 
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ONOCR 0000020 No CR output at column 0. 
ONLRET 0000040 NL performs CR function. 
OFILL 0000100 Use fill characters for delay. 
OFDEL 0000200 Fillis DEL, else NUL. 
NLDLY 0000400 Select new-line delays: 

NLO 0 

NL1 0000400 

CRDLY 0003000 Select carriage-return delays: 
CRO 0 

CR1 0001000 

CR2 0002000 

CR3 0003000 

TABDLY 0014000 Select horizontal-tab delays: 
TABO 0 

TAB1 0004000 

TAB2 0010000 

TAB3 0014000 Expand tabs to spaces. 
BSDLY 0020000 Select backspace delays: 
BSO 0 

BS1 0020000 

VTDLY 0040000 Select vertical-tab delays: 
vTo 0 | 

vT1 0040000 

FFDLY 0100000 Select form-feed delays: 
FFO 0 

FF1 0100000 
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If OPOST is set, output characters are post-processed as indicated by the remaining flags, oth- 
erwise characters are transmitted without change. 


lf OLCUC is set, a lower-case alphabetic character is transmitted as the corresponding upper- 
case character. This function is often used in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, 
the CR character is transmitted as the NL character. If ONOCR is set, no CR character is 
transmitted when at column 0 (first position). If ONLRET is set, the NL character is assumed to 
do the carriage-return function; the column pointer will be set to 0 and the delays specified for 
CR will be used. Otherwise the NL character is assumed to do just the line-feed function; the 
column pointer will remain unchanged. The column pointer is also set to 0 if the CR character is 
actually transmitted. 


The delay bits specify how long transmission stops to allow for mechanical or other movement 
when certain characters are sent to the terminal. In all cases a value of 0 indicates no delay. If 
OFILL is set, fill characters will be transmitted for delay instead of a timed delay. This is useful 
for high baud rate terminals which need only a minimal delay. If OFDEL is set, the fill character 
is DEL, otherwise NUL. 


lf a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 


New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return delays are used 
instead of the new-line delays. If OFILL is set, two fill characters will be transmitted. 


Carriage-return delay type 1 is dependent on the current column position, type 2 is about 0.10 
seconds, and type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits two fill char- 
acters, and type 2 four fill characters. 


Horizontal-tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 


- seconds. Type 3 specifies that tabs are to be expanded into spaces. If OFILL is set, two fill 
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characters will be transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character will be transmitted. 
The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c_cflag field describes the hardware control of the terminal: 





CBAUD 0000017 Baud rate: 

BO 0 Hang up 

B50 0000001 50 baud 

B75 0000002 75 baud 

B110 0000003 110 baud 

B134 0000004 134.5 baud 

B150 0000005 150 baud 

B200 0000006 200 baud 

B300 0000007 300 baud 

Bé6é00 0000010 600 baud 

B1200 0000011 1200 baud 

B1800 0000012 1800 baud 

B2400 0000013 2400 baud 

B48s00 0000014 4800 baud 

B9600 0000015 9600 baud 

EXTA 0000016 External A (19200 baud) 
EXTB 0000017 External B 

CSIZE 0000060 Character size: 

CS5 0 5 bits 

CS6 0000020 6 bits 

CS7 0000040 7 bits 

CS8 OOO00060 8 bits 

CSTOPB 0000100 Send two stop bits, else one. 
CREAD 0000200 Enable receiver. 
PARENB 0000400 Parity enable. 
PARODD 0001000 Odd parity, else even. 
HUPCL 0002000 Hang up on last close. 
CLOCAL 0004000 Local line, else dial-up. 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connec- 
tion. If BO is specified, the data-terminal-ready signal will not be asserted. Normally, this will 
disconnect the line. For any particular hardware, impossible speed changes are ignored. 


The baud rate for EXTB is determined from switch settings in the hardware. See the Plexus 
User's Manual for details. 


The CSIZE bits specify the character size in bits for both transmission and reception. This size 
does not include the parity bit, if any. If CSTOPB is set, two stop bits are used, otherwise one 
stop bit. For example, at 110 baud, two stops bits are required. 


lf PARENB is set, parity generation and detection is enabled and a parity bit is added to each 


character. If parity is enabled, the PARODD flag specifies odd parity if set, otherwise even parity 
is used. 


If CREAD is set, the receiver is enabled. Otherwise no characters will be received. 


lf HUPCL is set, the line will be disconnected when the last process with the line open closes it 
or terminates. That is, the data-terminal-ready signal will not be asserted. 


If CLOCAL is set, the line is assumed to be a local, direct connection with no modem control. 
Otherwise modem control is assumed. 
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The initial hardware control value after open is B300, CS8, CREAD, HUPCL. 


The c_iflag field of the argument structure is used by the line discipline to control terminal func- 
tions. The basic line discipline (0) provides the following: 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill processing). 
XCASE 0000004 Canonical upper/lower presentation. 

ECHO 0000010 Enable echo. 

ECHOE 0000020 Echo erase character as BS-SP-BS. 
ECHOK 0000040 Echo NL after kill character. 

ECHONL 0000100 Echo NL. 

NOFLSH 0000200 Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control characters INTR and 
QUIT. If an input character matches one of these control characters, the function associated 
with that character is performed. If ISIG is not set, no checking is done. Thus these special 
input functions are possible only if ISIG is set. These functions may be disabled individually by 
changing the value of the control character to an unlikely or impossible value (e.g. 0377). 


If CANON is set, canonical processing is enabled. This enables the erase and kill edit functions, 
and the assembly of input characters into lines delimited by NL, EOF, and EOL. If ICANON is not 
set, read(2) requests are satisfied directly from the input queue. A read will not be satisfied until 
at least MIN characters have been received or the timeout value TIME has expired. This allows 
fast bursts of input to be read efficiently while still allowing single character input. The MIN and 
TIME values are stored in the position for the EOF and EOL characters respectively. The time 
value represents tenths of seconds; values for TIME range from 2 to 255. If TIME has the value 
0 or 1, no timeout occurs. 








If XCASE is set, and if ICANON is set, an upper-case letter is accepted on input by preceding it _ 
with a \ character, and is output preceded by a \ character. In this mode, the following escape ~ 
sequences are generated on output and accepted on input: 


for: use: 
\! 

l \s 

{ \( 

} \) 

\ \\ 


For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If ECHO and ECHOE are set, the 
erase character is echoed as ASCII BS SP BS, which will clear the last character from a CRT 
screen. If ECHOE is set and ECHO is not set, the erase character is echoed as ASCII SP BS. If 
ECHOK is set, the NL character will be echoed after the kill character to emphasize that the line 
will be deleted. Note that an escape character preceding the erase or kill character removes 
any special function. If ECHONL is set, the NL character will be echoed even if ECHO is not set. 
This is useful for terminals set to local echo (so-called half duplex). Unless escaped, the EOF 
character is not echoed. Because EOT is the default EOF character, this prevents terminals that 
respond to EOT from hanging up. 


If NOFLSH is set, the normal flush of the input and output queues associated with the quit and 
interrupt characters will not be done. When NOFLSH is set, a de/ (0177) or a °| will cause a sig- 
nal to be sent to the process. This process will be terminated. The character has already been 
placed in the raw queue and will be read with the next read. 
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The initial line-discipline control value is all bits clear. 


The primary joct/(2) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio «arg; 


The commands using this form are: 


TCGETA 


TCSETA 


TCSETAW 


TCSETAF 


Get the parameters associated with the terminal and store in the termio 
structure referenced by arg. 


Set the parameters associated with the terminal from the structure refer- 
enced by arg. The change is immediate. 


Wait for the output to drain before setting the new parameters. This form 
should be used when changing parameters that will affect output. 


Wait for the output to drain, then flush the input queue and set the new 
parameters. 


Additional ioct!(2) calls have the form: 
ioctl (fildes, command, arg) 


int arg; 


The commands using this form are: 


TCSBRK 
TCXONC 
TCFLSH 


FILES 
/devitty 
/devitty « 
/dev/console 
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Wait for the output to drain. If arg is 0, then send a break (zero bits for 
0.25 seconds). 


Start/stop control. If arg is 0, suspend output; if 1, restart suspended out- 
put. 


If arg is O, flush the input queue; if 1, flush the output queue; if 2, flush 
both the input and output queues. 
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NOTES 
Plexus defines two extra flags in the c_iflag field of the <termio.h> structure. They are 





15 14 
|SRISES [Omere (Somer: tac] SURO eer: PPR cok retell ae en ERC ea Sune Dore NOSE Sa RE Oe nee eRe nee eet eer ee l 
| {_._.. ICTS 
| 
Pc Se oe ICTSLO 
_ where 

ICTS specifies that Clear to Send (CTS) is to be used as flow control. Note that XON and 
XOFF processing is not disabled. Also, the ICP must be configured to accept the CTS 
signal. 


ICTSLO __ inverts the action of the CTS activity. This is for use with devices in which the polar- 
ity of the CTS signal is inverted. 


These two flags are not supported in stock SYSTEM Ill. The location of these flags may also 
change in future releases. This feature is available on ICP ports only. 


The ICPs that correspond to tty device addresses are as follows: 


/devittyO - /dev/tty7 ICP 0 
/devitty8 - /dev/tty15 ICP 1 
/devitty16 - /dev/tty23 ICP 2 
/devitty24 - /dev/tty31 ICP 3 
/devitty32 - /dev/tty39 ICP 4 





At least one ICP must be reserved if you use the Virtual Protocol Machine (VPM). This must be 
the first ICP, or, if you use more than one VPM ICP, the first n ICPs. 


The VPM ICP may function as a TTY ICP, although not at the same time it is being used for 
VPM. 


If you use your VPM ICP as a TTY ICP, you will probably want two sets of mknods, and two 
each of the /etc/inittab and /ete/re files. The idea is to switch back and forth between the sets 
as you move from VPM applications to TTY applications. Two sets are required because you 
will want to disable logins on the TTY ports of the VPM ICP when it is in use for VPM; other- 
wise, continuous gettys are done for those ports. Switching back and forth is not a trivial pro- 
cedure; you must reboot each time you change over. A shell procedure incorporating all the 
steps makes it somewhat easier. 


SEE ALSO 
stty(1), ioctl(2), icp(4). 
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NAME 





vpm - The Virtual Protocol Machine 


DESCRIPTION 


This entry describes a particular kind of special file and gives an introduction to the Virtual Pro- 
tocol Machine (VPM). 


The VPM is a software construct for implementing link protocols on the ICP in a high-level 
language. This is accomplished by a compiler that runs on UNIX and that translates a high-level 


language description of a protocol into an intermediate language that is interpreted by an inter- 
preter running in the ICP. 


The VPM driver is functionally split into two parts: a top VPM device and a bottom VPM device. 
The top device may be modified or replaced to suit particular applications; the bottom device 
interfaces with the VPM interpreter using the ICP driver. When using the mknod command to 
make a directory entry and corresponding i-node for a VPM special file, the minor device 
number identifies the physical ICP device, the VPM protocol number, and the physical ICP line 
number to be used for this special file. The two most significant bits of the minor device number 
denote the physical ICP device; the next two bits denote the VPM protocol number; the four least 
significant bits denote the VPM ICP line number. For example, if ICP device 1 is to be used with 
protocol number 2, which in turn is to be used with ICP device 3, the minor device number would 
be 0143 (octal). 


UNIX user processes transfer data to or from a remote terminal or computer system through 
VPM using normal open, read, write, and close operations. Flow control and error recovery are 
provided by the protocol description residing in the ICP. 


The VPM software consists of six components: 





1. vemc(1C): compiler for the protocol description language; it runs on UNIX. 

2. VPM interpreter: a ICP program that controls the overall operation of the ICP and 
interprets the protocol script. 

3. Si.c: a UNIX driver that provides the interface to the VPM. 

4. vpmstart(1C): a UNIX command that copies a load module into the ICP and 
Starts it. 

5. vpmsnap(1C): a UNIX command that prints a time-stamped event trace while 
the protocol is running. 

6. vpmtrace(1C): a UNIX command that prints an event trace for debugging pur- 


poses while the protocol is running. 


The VPM open for reading-and-writing is exclusive; opens for reading-only or writing-only are 
not. The VPM open checks that the correct interpreter is running in the ICP, then sends a RUN 
command to the interpreter (causing it to start interpreting the protocol script), and supplies a 
512-byte receive buffer to the interpreter. 


The VPM read returns either the number of bytes requested or the number remaining in the 
current receive buffer, whichever is less. Bytes remaining in a receive buffer are used to satisfy 
subsequent reads. The VPM write copies the user data into 512-byte system buffers and 
passes them to the VPM interpreter in the ICP for transmission. 


The VPM close arranges for the return of system buffers and for a general cleanup when the last 
transmit buffer has been returned by the interpreter. 


The user command vpmtrace(1C) reads the trace driver and prints event records. While this 
command is executing, the VPM driver will generate a number of event records, allowing the 
activity of the VPM driver and protocol script to be monitored for debugging purposes. The sys- 
tem functions vomopen, vpmread, vpmwrite, and vpmclose generate event records (identified 
respectively by 0, r, w, and c). Calls to the vemc(1C) primitive trace(arg1 ,arg2) cause the VPM 
interpreter to pass arg? and arg2 along with the current value of the script location counter to 
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the VPM driver, which generates an event record identified by a T. Each event record is struc- 
tured as follows: 


struct event { 





short e_seqn; /xsequence numbers/ 
char e_type; /xrecord identifiers/ 

char e_dev; /xminor device number s/ 
short e_short1; /xdatax/ 

short e_short2; /xdatas/ 


} 


When the script terminates for any reason, the driver is notified and generates an event record 
identified by an E. This record also contains the minor device number, the script location 
counter, and a termination code defined as follows: 


Normal termination; the interpreter received a halt command from the driver. 

Undefined virtual-machine operation code. 

Script program counter out of bounds. 

Interpreter stack overflow or underflow. 

Jump address not even. 

MULTIBUS error. 

Transmit buffer has an odd address; the driver tried to give the interpreter too 

many transmit buffers; or a get or rinxbuf was executed while no transmit buffer 

was open, i.e., no getxbuf was executed prior to the get or rtnxbuf. 

7 Receive buffer has an odd address; the driver tried to give the interpreter too 
many receive buffers; or a put or rtnrbuf was executed while no receive buffer 
was open, i.e., no getrbuf was executed prior to the get or rtnxbuf. 

8 The script executed an exit. 


anh GN — © 





9 A crc16 was executed without a preceding crcloc execution. 
10 Interpreter detected loss of modem-ready signal. 
11 Transmit-buffer sequence-number error. 
12 Command error; an invalid command or an improper sequence of commands 


was received from the driver. 
13 Not used. 
14 Invalid transmit state. 
15 Invalid receive state. 
16 Not used. 
17 Xmictil or setct! attempted while transmitter was still busy. 
18 Not used. 
19 Same as error code 6. 
20 Same as error code 7. 
21 Script to large. 
22 Used for debugging the interpreter. 
23 The driver’s OK-check has timed out. 


SEE ALSO 
vpmce(1C), vpmstart(1C), trace(4). 
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NAME 





intro - introduction to file formats 


DESCRIPTION 
This section outlines the formats of various files. The C struct declarations for the file formats 
are given where applicable. Usually, these structures can be found in the directories 
/usr/include or /usr/include/sys. 


NOTES 
Plexus adds D-hosts, for use with the Plexus Network Operating System (NOS). Plexus also 
adds holidays, termcap, and ttytype and does not currently support master. 
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NAME 


a.out - assembler and link editor output 


DESCRIPTION 


Page 1 


A.out is the output file of the assembler as and the link editor /d. Both programs will make 
a.out executable if there were no errors in assembling or linking, and no unresolved external 
references. 


This file has four sections: a header, the program text and data segments, relocation informa- 
tion, and a symbol table (in that order). The last two sections may be missing if the program 
was linked with the -s option of /d(1) or if the symbol table and relocation bits were removed by 
strip(1). Also note that if there were no unresolved external references after linking, the reloca- 
tion information will be removed. 


The sizes of each segment (contained in the header, discussed below) are in bytes and are 
even. The size of the header is not included in any of the other sizes. 


When an a.out file is loaded into memory for execution, three logical segments are set up: the 
text segment, the data segment (initialized data followed by uninitialized, the latter actually being 
initialized to all O's), and a stack. The text segment begins at location 0 in the core image; the 
header is not loaded. If the magic number (the first field in the header) is 107 (hexadecimal), it 
indicates that the text segment is not to be write-protected or shared, so the data segment will 
be contiguous with the text segment. If the magic number is 108 (hexadecimal), the data seg- 
ment begins at the first 0 mod 2K byte boundary (Z8000) or the first 0 mod 4K byte boundary 
(MC68000) following the text segment, and the text segment is not writable by the program; if 
other processes are executing the same a.out file, they will share a single text segment. For 
the Z8000 only, if the magic number is 109 (hexadecimal), the text segment is again pure 
(write-protected and shared); moreover, the instruction and data spaces are separated. The 
text and data segment both begin at location 0. See the Zilog Z8000 Instruction Manual for res- 
trictions that apply to this situation. 


The stack will occupy the highest possible locations in the core image: on the 28000, from FFFE 
(hexadecimal) and growing downwards; on the MC68000, from 1FFFFC and growing down- 
wards. The stack is automatically extended as required. The data segment is only extended as 
requested by the brk(2) system call. 


The start of the text segment in the a.out file is hsize; the start of the data segment is hsize--S, 
(the size of the text), where hsize is 10 (hexadecimal). 


The value of a word in the text or data portions that is not a reference to an undefined external 
symbol is exactly the value that will appear in memory when the file is executed. If a word in 
the text or data portion involves a reference to an undefined external symbol, as indicated by the 
relocation information (discussed below) for that word, then the value of the word as stored in 
the file is an offset from the associated external symbol. When the file is processed by the link 
editor and the external symbol becomes defined, the value of the symbol will be added to the 
word in the file. 
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Header-Z8000 
The format of the a.out header is as follows: 


struct exec 

_ short a_magic; /x magic number +/ 
unsigned a_text; /« size of text segment +/ 
unsigned a_data; /« size of data segment +«/ 
unsigned a_bss; /« size of bss segment +/ 
unsigned a_syms; /« size of symbol table «/ 
unsigned a_entry; /« entry point of program «/ 
unsigned a_stamp;/« version stamp +/ 
unsigned a_flag; /« set if relocation info stripped «/ 





}; 
Header-MC68000 
The format of the header on the MC68000 is as follows: 


struct bhdr { 
long fmagic; /« magic number +«/ 
long tsize; /« size of text segment +/ 
long dsize; /« size of data segment «/ 
long bsize; /« size of bss segment +/ 
long ssize; /« size of symbol table +/ 
long rtsize; /« size of text relocation info +/ 
long rdsize; /« size of data relocation info +/ 
long entry; /« entry point of program +/ 
}; 


Relocation-Z8000 
If relocation information is present, it amounts to two bytes per relocatable datum. There is no 
relocation information if the “suppress relocation” flag (a_flag) in the header is on. 
The format of the relocation data is: 
struct r_info { 
int r_symbolnum:11; 
r_segment:3; 
r_pcrel:1; 





}; 
The r_pcrel field is not used. 


The r_segment field indicates the segment referred to by the text or data word associated with 
the relocation word: 


00 indicates the reference is absolute; 

02 indicates the reference is to the text segment; 

04 _ indicates the reference is to initialized data; 

06 indicates the reference is to bss (uninitialized data); 

10 indicates the reference is to an undefined external symbol. 


The field r_symboinum contains a symbol number in the case of external references, and is 
unused otherwise. The first symbol is numbered 0, the second 1, etc. 


The start of the relocation information is 


hsize +- a_text + a_data 
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Relocation-MC68000 
Relocation information, if it is present, is given for each datum to be relocated. 


The format of the relocation information is: 





struct reloc { | 
unsigned rsegment:2;/x RTEXT, RDATA, RBSS, or REXTERN «/ 


unsigned rsize:2; /x RBYTE, RWORD, or RLONG +/ 
unsigned rdisp:1; /x 1 => adisplacement +/ 

unsigned relpad1:3;/* unused portion of relocation tag +/ 

char relpad2; /x unused portion of relocation tag +/ 

short rsymbol; /x id of the symbol of external relocations +/ 
long rpos; /x position of relocation in segment «/ 


hi 
The rsegment field indicates the segment referred to by the relocated datum. 


00 indicates the reference is to the text segment; 

01 indicates the reference is to initialized data; 

02 indicates the reference is to bss (uninitialized data); 

03 indicates the reference is to an undefined external symbol. 


The rsize field indicates the size of the datum: 
00 _ indicates the datum is one byte; 
01 indicates the datum is one word; 
02 indicates the datum is a long. 


The field rsymbol contains a symbol number in the case of external references. The first sym- 
bol is numbered 0, the second 1, etc. The start of the text relocation information is 





tsize +- dsize +- ssize 
The start of the data relocation information is 


hsize +- tsize +- dsize + ssize +- rtsize 


Symbol Table-Z8000 
The symbol table on the Z8000 consists of entries of the form: 


struct nlist { 
char n_name{8]; 
int n_type; 


unsigned n_value; 
}: 
The n_name field contains the ASCII name of the symbol, null-padded. The n_type field indi- 
cates the type of the symbol; the following values are possible: 
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000 undefined symbol 

001 absolute symbol 

002 text segment symbol 

003 data segment symbol 

004 bss segment symbol 

037 file name symbol (produced by /d) 
040 undefined external symbol 
041 absolute external symbol 

042 text segment external symbol 
043 data segment external symbol 
044 bss segment external symbol 


The start of the symbol table on the Z8000 is: 
hsize +2(a_text +-a_data) 

if relocation information is present, and 
hsize +-a_text +-a_data 


if it is not. 


A.OUT(5) 


If a symbol's type is undefined external and the value field is non-zero, the symbol is interpreted 
by the link editor /d(1) as the name of a common region whose size is indicated by the value of 


the symbol. 
Symbol Table-MC68000 


The symbol table on the MC68000 consists of entries of the form: 


struct sym { 
char stype; 
char sympad; 
long svalue; 
} 


/x symbol type +/ 
/* pad to long align +/ 
/*x value «/ 


The symbol follows each entry and is null-terminated. The stype field indicates the type of the 


symbol; the following values are possible: 


000 undefined symbol 

001 absolute symbol 

002 text segment symbol 

003 data segment symbol 

004 bss segment symbol 

037 file name symbol (produced by /d) 
024 register name 

040 external bit or’d in 

"%08x" format for printing a value 


The start of the symbol table on the MC68000 is 
hsize +- tsize +- dsize 


If a symbol’s type is undefined external and the value field is non-zero, the symbol is interpreted 
by the link editor /d(1) as the name of a common region whose size is indicated by the value of 


the symbol. 


SEE ALSO 
as(1), [d(1), nm(1), strip(1). 


March 29, 1984 


Page 4 


ACCT(5) 


NAME 


ACCT(5) 


acct - per-process accounting file format 


SYNOPSIS 
#include <sys/acct.h> 


DESCRIPTION 


Files produced as a result of calling acct(2) have records in the form defined by <sys/acct.h>, 


whose contents are: 
‘ha : 
* Accounting structures 
*/ 


typedef ushort comp_t; 


struct acct 

{ 
char ac_flag; 
char ac_stat; 
ushort ac_uid; 
ushort ac_gid; 
dev_t  ac_tty; 
time_t ac_btime; 
comp_t ac_utime; 
comp_t ac_stime; 
comp_t ac_etime; 
comp_t ac_mem; 
comp_t ac_io; 
comp_t ac_rw; 
char ac_comm [8]; 


} 


extern struct acct 
extern struct inode 


#define AFORK 101 
#define ASU 02 
#define ACCTF 0300 


/* "floating point" */ 
/* 13-bit fraction, 3-bit exponent */ 


/* accounting flag */ 

/* exit status */ 

/* accounting user ID */ 

/* accounting group ID */ 

/* control typewriter */ 

/* beginning time */ | 

/* acctng user time in clock ticks */ 

/* acctng system time in clock ticks */ 
/* acctng elapsed time in clock ticks */ 
/* memory usage */ 

/* chars transferred */ 

/* blocks read or written */ 

/* command name */ 


acctbuf; 
*acctp;/* inode of accounting file */ 


/* has executed fork, but no exec */ 
/* used super-user privileges */ 
/* record type: 00 = acct */ 


In ac_flag, the AFORK flag is turned on by each fork(2) and turned off by an exec (2). The 
ac_comm field is inherited from the parent process and is reset by any exec. Each time the 
system charges the process with a clock tick, it also adds to ac_mem the current process size, 


computed as follows: 


(data size) + (text size) / (number of in-core processes using text) 
The value of ac_mem/ac_stime can be viewed as an approximation to the mean process size, 


as modified by text-sharing. 
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The following structure represents the total accounting format used by the various accounting 
commands: 

/* 

: total accounting (for acct period), also for day 


gi 

struct tacct { 
uid_t ta_uid; /* userid */ 
char ta_name[8]; /* login name */ 
float ta_cpu[2];  /* cum. cpu time, p/np (mins) */ 
float ta_kcore[2]; /* cum. kcore-minutes, p/np */ 
float ta_con(2];  /* cum. conn. time, p/np, mins */ 
float ta_du; /* cum. disk usage */ 
long ta_pc; /* count of processes */ 
unsigned short ta_sc; /* count of login sessions */ 
unsigned short ta_dc; /* count of disk samples */ 
unsigned short ta_fee; /* fee for special services */ 

}; 

SEE ALSO 
acct(1M), acctcom(1), acct(2). 


BUGS 
The ac_mem value for a short-lived command gives little information about the actual size of 
the command, because ac_mem may be incremented while a different command (e.g., the 
shell) is being executed by the process. 
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NAME 
ar - archive file format 


DESCRIPTION 
The archive command ar is used to combine several files into one. Archives are used mainly as 
libraries to be searched by the link editor /d(1). 


A file produced by ar has a magic number at the start, followed by the constituent files, each 
preceded by a file header. The magic number is 0177545(octal) (it was chosen to be unlikely to 
occur anywhere else). The header of each file is 26 bytes long: 


#ifdef z8000 
#define ARMAG 0177545 
struct ar_hdr { 
char ar_name[14]; 
long ar_date; 
char ar_uid; 
char ar_gid; 
int ar_mode; 
long ar_size; 
}; 
#else 
#define ARMAG "learch>0 
#define SARMAG_ 8 


#define ARFMAG "0 


struct ar_hdr { 
char ar_name[16]; 
char ar_date[12]; 
char ar_uid[6]; 
char ar_gid[6]; 
char ar_mode{[8]; 
char ar_size[10]; 
char ar_fmag[2]; 


} 

#endif 
Each file begins on a word boundary; a null byte is inserted between files if necessary. 
Nevertheless the size given reflects the actual size of the file exclusive of padding. 
Notice there is no provision for empty areas in an archive file. 


SEE ALSO 
ar(1), arcv(1), Id(1). 


BUGS 
The archive header structure is not compatible between the Z8000 and the 68000 due to the dif- 
ferent word sizes. See arcv(1) to convert between processors. 
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NAME 





checklist - list of file systems processed by fsck 


DESCRIPTION 
Checklist resides in directory /etc and contains a list of at most 15 special file names. Each 
special file name is contained on a separate line and corresponds to a file system. Each file 
system will then be automatically processed by the fsck(1M) command. 


SEE ALSO 
fsck(1M). 
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NAME 


core - format of core image file 


DESCRIPTION 


UNIX writes out a core image of a terminated process when any of various errors occur. See 
signal(2) for the list of reasons; the most common are memory violations, illegal instructions, 
bus errors, and user-generated quit signals. The core image is called core and is written in the 
process's working directory (provided it can be; normal access controls apply). A process with 
an effective user ID different from the real user ID will not produce a core image. 


The first section of the core image is a copy of the system's per-user data for the process, 
including the registers as they were at the time of the fault. The size of this section depends on 
the parameter usize, which is defined in /usr/include/sys/param.h. The remainder represents 
the actual contents of the user’s core area when the core image was written. If the text seg- 
ment is read-only and shared, or separated from data space, it is not dumped. 


The format of the information in the first section is described by the user structure of the sys- 
tem, defined in /usr/include/sys/user.h. The important stuff not detailed therein is the locations 
of the registers, which are outlined in /usr/include/sys/reg.h. 


SEE ALSO 
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NAME 
cpio - format of cpio archive 
DESCRIPTION 
The header structure, when the c option is not used, is: 
struct{ 
short h_magic, 
h_dev, 
h_ino, 
h_mode, 
h_uid, 
h_gid, 
h_nlink, 
h_rdev, 
h_mtime[2], 
h_namesize, 
h_filesize[2]; 
char h_name(h_namesize rounded to word]; 
} Har; 
When the c option is used, the header information is described by the statement below: 
sscanf(Chdr, "%60%60%60%60%60%60%60%60%1 1lo%60%60%s" ; 
&Hdr.h_magic,&Hdr.h_dev,&Hdr.h_ino,&Hdr.h_mode, 
&Hdr.h_uid,&Hdr.h_gid,&Hdr.h_nlink,&Hdr.h_rdev, 
&Longtime,&Hdr.h_namesize,&Longfile, Hdr.h_name); 
Longtime and Longfile are equivalent to Har.h_mtime and Hdr.h_filesize, respectively. The 
contents of each file is recorded in an element of the array of varying length structures, archive, 
together with other items describing the file. Every instance of h_magic contains the constant 
070707 (octal). The items h_dev through h_mtime have meanings explained in stat(2). The 
length of the null-terminated path name h_name, including the null byte, is given by 
h_namesize. 
The last record of the archive always contains the name TRAILERI!!!. Special files, directories, 
and the trailer are recorded with h_filesize equal to zero. 
SEE ALSO 
cpio(1), find(1), stat(2). 
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NAME 





D-hosts - configuration file for the Network Operating System (NOS) 


DESCRIPTION | 
The file /usr/lib/nos/D-hosts establishes the configuration of the Network Operating System 
(NOS). This file identifies the remote hosts accessible to the local host. It also specifies the pro- 
tocol and physical link to be used when communicating with a given remote host. 


/usr/lib/nos/D-hosts is read only at initialization time when the system is booted. ‘Hence to 
locally reconfigure the network, the system must be rebooted. An error message is uhh if 
the file cannot be located. 


The file /usr/lib/nos/D-hosts contains one line for each remote host. This line describes vari- 
ous properties of the remote host. Each line is composed of a number of fields: 


name:NA—xxxx:PL—ether:LL—pdic:NL—pdic:TL=—=ncf 


where 


name is the host name, remote or local. The name is limited to 9 characters; names longer than 
this are truncated. Only the characters 0-9, a-z, and A-Z may be used. The local host's 
name must match the ‘Sys3 nodename:’ as established via dconfig(8). 


NA network address. The associated value is a hexadecimal number designating the address 
of the host. The number is delivered with the Ethernet controller hardware. NA values 
are used by the hardware drivers to route communication packets at the physical level. 


PL physical level. This is the ‘type’ of the physical link. The associated value is a NOS- 
defined character string. The only physical media currently supported is ether. 


LL _iink level. This is the link layer of the protocol. The associated value is a NOS-defined " 
string. The only link level protocol currently supported is polc. ne 


NL network level. The network layer of the protocol. The associated value is a NOS-defined 
character string. The only net level protocol currently supported is pdic. 


TL transport level. The transport layer of the protocol. The associated value is a NOS- 
defined character string. The only transaction level protocol currently supported is nef. 


A line in /usr/lib/nos/D-hosts may be commented by beginning it with a ‘#’. A line may be 
extended by using a ‘\’ as the last character. This causes the EOL to be ignored, and the line 
may be continued on the following line. Spaces and tabs are ignored except as string and 
number delimiters. 


DIAGNOSTICS 
The following error messages may occur during boot because of an invalid configuration file: 


Can not open /usr/lib/nos/D-hosts 
You have not provided a configuration file in /usr/lib/nos. Check to ensure that file 
exists. This may also be a symptom of a damaged file system. 


no: <char> 
The delimiter of the fields within a descriptor is a ‘:’; an unknown character <char> 
was encountered instead of the expected ‘:’. Check file for bad entry or invisible charac- 





ters. 

no = <char> 
The assignment operator within each field is a ‘='; an unknown character <char> was 
encountered instead of the expected ‘=’. Check file for bad entry or invisible charac- 
ters. 
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unknown type of ncf initalization argument <string> 
The configuration paramter argument was illegal. Only NA, PL, LL, NL, and TL are 
allowed. 


physical layer ..." not yet implemented" 
Currently only ‘ether’ is valid as a PL value. 





Unknown host id 
driver address (... ) not found in configuration table 
The address of the hardware was not found in the configuration table. Add an entry for 
your device into the file. 


configuration table device name (..) does not match host nodename (..) 
The host name is obtained from the disk at boot time. It does not agree with the name 
given the host in the configuration file. Change the configuration file or use dconfig(8) to 
change host name so that both are consistent. 
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NAME 





dir - format of directories 


SYNOPSIS 
#include <sys/dir.h> 


DESCRIPTION 
A directory behaves exactly like an ordinary file, save that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry (see 
fs(5)). The structure of a directory entry as given in the include file is: 


#ifndef DIRSIZ 
#define DIRSIZ 14 
#endif 

struct direct 


ino_t d_ino; 
char d_name[DIRSIZ]; 
}; 
By convention, the first two entries in each directory are for . and ... The first is an entry for the 
directory itself. The second is for the parent directory. The meaning of .. is modified for the root 
directory of the master file system; there is no parent, so .. has the same meaning as .. 


SEE ALSO 
fs(5). 
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NAME 


dump - incremental dump tape format 


DESCRIPTION 


The dump and restor commands are used to write and read incremental dump magnetic tapes. 


The dump tape consists of a header record, some bit mask records, a group of records describ- 
ing file system directories, a group of records describing file system files, and some records 
describing a second bit mask. 


The header record and the first record of each description have the format described by the 
structure included by | 


#include <dumprestor.h> 
This include file has the following contents: 


#define NTREC 10 
#define MLEN 16 
#define MSIZ 4096. 

— #define TS_TAPE 1 
#define TS_INODE 2 
#define TS_BITS 3 
#define TS_ADDR 4 
#define TS_END 5 
#define TS_CLRI 6 
#define MAGIC (int)6001 1 
#define CHECKSUM  (int)84446 
struct spcl 
{ 

int —C_type; 
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time_t c_date; 
time_t c_ddate; 
int c_volume; 
daddr_t c_tapea; 
ino_t c_inumber; 


int Cc_magic; 
int c_checksum; 
struct dinode c_dinode; 
int c_count; 
char  c_addr{BSIZE]; 
} spel; 3 
struct idates 
{ 
char  id_name{16]; 
char __id_incno; 
time_t id_ddate; 
}; 


NTREC is the number of 1024 byte blocks in a physical tape record. MLEN is the number of bits 
in a bit map word. MS/Z is the number of bit map words. 


The TS_ entries are used in the c_type field to indicate what sort of header this is. The types 
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and their meanings are as follows: 


TS_TYPE 
TS_INODE 


TS_BITS | 
TS_ADDR 
TS_END 
TS_CLRI 


MAGIC 
CHECKSUM 


Tape volume label 


A file or directory follows. The c_dinode field is a copy of the disk inode and con- 
tains bits telling what sort of file this is. 


A bit mask follows. This bit mask has a one bit for each inode that was dumped. 
A subblock to a file (TS_INODE). See the description of c_count below. 
End of tape record. 


A bit mask follows. This bit mask contains a one bit for all inodes that were empty 
on the file system when dumped. 


All header blocks have this number in c_magjic. 
Header blocks checksum to this value. 


The fields of the header structure are as follows: 


c_type 
c_date 


c_ddate 
c_volume 
c_tapea 
c_inumber 
c_magic 
c_checksum 
c_dinode 
c_count 


c_addr 


The type of the header. 

The date the dump was taken. 

The date the file system was dumped from. 

The current volume number of the dump. 

The current block number of this record. This is counting 1024 byte blocks. 
The number of the inode being dumped if this is of type TS_INODE. 

This contains the value MAGIC above, truncated as needed. 

This contains whatever value is needed to make the block sum to CHECKSUM. 
This is a copy of the inode as it appears on the file system. 


This is the count of characters following that describe the file. A character is zero 
if the block associated with that character was not present on the file system, oth- 
erwise the character is non-zero. If the block was not present on the file system 
no block was dumped and it is replaced as a hole in the file. If there is not suffi- 
cient space in this block to describe all of the blocks in a file, TS_ADDR blocks will 
be scattered through the file, each one picking up where the last left off. 


This is the array of characters that is used as described above. 


Each volume except the last ends with a tapemark (read as an end of file). The last volume 
ends with a TS_END block and then the tapemark. 


The structure idates describes an entry of the file where dump history is kept. 


SEE ALSO 


dump(1M), restor(1M), fs(5). 


March 29, 1984 


Page 2 











ERRFILE(5) ERRFILE(5) 


NAME 
errfile - error-log file format 


DESCRIPTION 
When hardware errors are detected by the system, an error record is generated and passed to 
the error-logging daemon for recording in the error log for later analysis. The default error log is 
/usr/adm/errfile. , 


The format of an error record depends on the type of error that was encountered. Every record, 
however, has a header with the following format: 





struct errhdr { 


int e_type; /* record type +/ 
int e_len; /x bytes in record (inc hdr) «/ 
time_t e_time; /x time of day +/ 
}; 
The permissible record types are as follows: 
#define E.GOTS 010 /x Start for UNIX 3.0%/ 
#define E.GORT 011 /*x Start for UNDURT «/ 
#define E.STOP 012 /x Stop «/ 
#define E.TCHG 013 /« Time change +/ 
#define E.CCHG 014 /x Configuration change +«/ 
#define E_BLK 020 /* Block device error +/ 
#define ELSTRAY 030 /* Stray interrupt «/ 
#define ELPRTY 031 /* Memory parity +/ 





Some records in the error file are of an administrative nature. These include the startup record 
that is entered into the file when logging is activated, the stop record that is written if the dae- 
mon is terminated “gracefully”, and the time-change record that is used to account for changes 
in the system's time-of-day. These records have the following formats: 


struct estart { 


struct errhdr e_hdr; /x record header +/ 
int e@_cCpu; /x CPU type +/ 
int e_mmrs3; /x contents mem mgmt reg 3 «/ 
long e_syssize; /+ Z8000 system memory size +/ 
int e_bconf; /* block dev configuration +/ 
}; 
structeend{ — 
struct errhdr e_hdr; /x record header «/ 
}; 
struct etimchg { 
struct errhdr e_hdr; /* record header «/ 
time_t e_ntime; /x new time «/ 
}; 
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Stray interrupts cause a record with the following format to be logged in the file: 


struct estray { | 
struct errhdr e_hdr; 
physadr — e@_saddr; 
int e_sbacty; 


}; 


/s record header +/ 
/* stray loc or device addr +/ 
/x active block devices +/ 


Memory subsystem error on 11/70 processors cause the following record to be generated: 


struct eparity { 
struct errhdr e_hdr; 


/*x record header +/ 
/*« memory subsys registers +/ 


/* record header +/ 

/*x "true" major +- minor dev no +/ 
/* controller address +/ 

/* other block I/O activity »/ 


/*x number read/writes +/ 
/* number "other" operations +/ 
/* number unlogged errors +/ 


/» read/write, error, etc +/ 

/x logical dev start cyl +/ 

/* logical block number +/ 

/*« number bytes to transfer +/ 
/* buffer memory address +/ 


_/*« number retries +/ 


/x number device registers +/ 


int e_parreg[5]; 
}; 
Error records for block devices have the following format: 
struct eblock { 
struct errhdr e_hdr; 
dev_t e_dev; 
physadr e_regloc; 
int e_bacty; 
struct iostat { 
long io _Ops; 
long io_misc; 
unsigned io_unlog; 
} e_stats; 
int e_bflags; 
int e_cyloff; 
-daddr_t e_bnum; 
unsigned e_bytes; 
long e_memadd; 
unsigned e_rtry; 
int e_nreg; 
}; 


The following values are used in the e_bffags word: 


#define E.WRITE 0 
#define E.READ 1 
#define ELNOIO 02 
#define E.LPHYS 04 
#define E.MAP 010 
#define ELERROR 020 


/» write operation +/ 

/* read operation +/ 

/x no I/O pending +/ 

/« physical 1/O +/ 

/x Unibus map in use +/ 
/x V/O failed +/ 


The “true” major device numbers that identify the failing device are as follows: 


#define PDO 0 
#define PTO 1 
#define ISO 2 
#define RMO 3 
SEE ALSO 
errdemon(1M). 
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NAME 





file system - format of system volume 


SYNOPSIS 
#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 

DESCRIPTION 
Every file system storage volume (e.g., RPO4 disk) has a common format for certain vital infor- 
mation. Every such volume is divided into a certain number of 1024 byte blocks. Block 0 is 
unused and is available to contain a bootstrap program or other information. 


Block 1 is the super-block. Starting from its first word, the format of a super-block is: 





/* 

* Structure of the super-block 

*/ 

struct filsys 

{ 
ushort __s_isize; /* size in blocks of i-list */ 
daddr_t_ s_fsize; /* size in blocks of entire volume */ 
short s_nfree; /* number of addresses in s_free */ 
daddr_t s_free[NICFREE]; /* free block list */ 
short —_ S_ninode; /* number of i-nodes in s_inode */ 
ino_t s_inode[NICINOD]; /* free i-node list */ 
char S_ flock; /* lock during free list manipulation */ 
char s_ilock; /* lock during i-list manipulation */ 
char s_fmod; /* super block modified flag */ 
char S_ronly; /* mounted read-only flag */ 
time_t  s_time; /* last super block update */ 
short s_dinfo[4]; /* device information */ 
daddr_t_ s_tfree; /* total free blocks*/ 
ino_t s_tinode; /* total free inodes */ 
char s_fname[6]; /* file system name */ 
char s_fpack[6]; /* file system pack name */ 

}; 


_ S§_isize is the address of the first data block after the i-list; the i-list starts just after the super- 
block, namely in block 2; thus the i-list is s_isize-2 blocks long. S_fsize is the first block not 
potentially available for allocation to a file. These numbers are used by the system to check for 
bad block numbers; if an “impossible” block number is allocated from the free list or is freed, a 
diagnostic is written on the on-line console. Moreover, the free array is cleared, so as to | 
prevent further allocation from a presumably corrupted free list. 


The free list for each volume is maintained as follows. The s_free array contains, in s_free[1], 
..., S_free[s_nfree-1], up to 49 numbers of free blocks. S_free[0] is the block number of the 
head of a chain of blocks constituting the free list. The first long in each free-chain block is the 
number (up to 50) of free-block numbers listed in the next 50 longs of this chain member. The 
first of these 50 blocks is the link to the next member of the chain. To allocate a block: decre- 
ment s_nfree, and the new block is s_free[{s_nfree]. If the new block number is 0, there are no 
blocks left, so give an error. If s_nfree became 0, read in the block named by the new block 
number, replace s_nfree by its first word, and copy the block numbers in the next 50 longs into 
the s_free array. To free a block, check if s_nfree is 50; if so, copy s_nfree and the s_free 
array into it, write it out, and set s_nfree to 0. In any event set s_free[s_nfree] to the freed 
block’s number and increment s_nfree. 
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S_tfree is the total free blocks available in the file system. 





S_ninode is the number of free i-numbers in the s_inode array. To allocate an i-node: if 
S_ninode is greater than 0, decrement it and return s_inode[s_ninode]. If it was 0, read the i- 
list and place the numbers of all free inodes (up to 100) into the s_inode array, then try again. 
To free an i-node, provided s_ninode is less than 100, place its number into s_inode[s_ninode] 
and increment s_ninode. If s_ninode is already 100, do not bother to enter the freed i-node into 
any table. This list of i-nodes is only to speed up the allocation process; the information as to 
whether the inode is really free or not is maintained in the inode itself. 


S_tinode is the total free inodes available in the file system. 


S_flock and s_ilock are flags maintained in the core copy of the file system while it is mounted 
and their values on disk are immaterial. The value of s_fmod on disk is likewise immaterial; it is 
used as a flag to indicate that the super-block has changed and should be copied to the disk 
during the next periodic update of file system information. 


S_ronly is a read-only flag to indicate write-protection. 


S_time is the last time the super-block of the file system was changed, and is a double- 
precision representation of the number of seconds that have elapsed since 00:00 Jan. 1, 1970 
(GMT). During a reboot, the s_time of the super-block for the root file system is used to set the 
system's idea of the time. 


S_fname is the name of the file system and s_fpack is the name of the pack. 


l-numbers begin at 1, and the storage for i-nodes begins in block 2. Also, i-nodes are 64 bytes 
long, so 16 of them fit into a block. Therefore, i-node / is located in block (/-+-31)/16, and 
begins 64 x ((i-+-31) (mod 16)) bytes from its start. I-node 1 is reserved for future use. I-node 
2 is reserved for the root directory of the file system, but no other i-number has a built-in mean- 
ing. Each i-node represents one file. For the format of an inode and its flags, see inode (5). 


FILES 
/usr/include/sys/filsys.h 
/ustr/include/sys/stat.h 


NOTES 
Block size is 1024 bytes, so the formulas given here for calculating the whereabouts of i-nodes 
are slightly different from stock SYSTEM Ill. 


SEE ALSO 
fsck(1M), fsdb(1M), mkfs(1M), inode(5). 








March 29, 1984 Page 2 











FSPEC(5) FSPEC(5) 


NAME 


fspec - format specification in text files 


DESCRIPTION 


It is sometimes convenient to maintain text files on UNIX with non-standard tabs, (i.e., tabs 
which are not set at every eighth column). Such files must generally be converted to a standard 
format, frequently by replacing all tabs with the appropriate number of spaces, before they can 
be processed by UNIX commands. A format specification occurring in the first line of a text file 
specifies how tabs are to be expanded in the remainder of the file. 


A format specification consists of a sequence of parameters separated by blanks and sur- 
rounded by the brackets <: and :>. Each parameter consists of a keyletter, possibly followed 
immediately by a value. The following parameters are recognized: 


ttabs The t parameter specifies the tab settings for the file. The value of tabs must be 
one of the following: 


1. a list of column numbers separated by commas, indicating tabs set at the 
specified columns; 


2. a - followed immediately by an integer n, indicating tabs at intervals of n 
columns; 


3. a- followed by the name of a “canned” tab specification. 


Standard tabs are specified by t-8, or equivalently, t1,9,17,25,etc. The canned tabs 
which are recognized are defined by the tabs(1) command. 


ssize The s parameter specifies a maximum line size. The value of size must be an 
integer. Size checking is performed after tabs have been expanded, but before the 
margin is prepended. 


mmargin The m parameter specifies a number of spaces to be prepencen to each line. The 
value of margin must be an integer. 


d The d parameter takes no value. Its presence indicates that the line containing the 
format specification is to be deleted from the converted file. 


e The e parameter takes no value. Its presence indicates that the current format is to 
prevail only until another format specification is encountered in the file. 


Default values, which are assumed for parameters not supplied, are t-8 and m0. If the s param- 
eter is not specified, no size checking is performed. If the first line of a file does not contain a 
format specification, the above defaults are assumed for the entire file. The following is an 
example of a line containing a format specification: 


« <:t5,10,15 s72:> « 


lf a format specification can be disguised as a comment, it is not necessary to code the d 
parameter. 


Several UNIX commands correctly interpret the format specification for a file. Among them is 
gath (see send(1C)) which may be used to convert files to a standard format acceptable to 
other UNIX commands. 


SEE ALSO 
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NAME 





group - group file a ; 


DESCRIPTION 
Group contains for each group the following information: 


group name 

encrypted password 

numerical group ID 

comma-separated list of all user allowed in the group 


This is an ASCII file. The fields are separated by colons; each group is separated from the next 
by a new-line. If the password field is null, no password is demanded. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have 
general read permission and can be used, for example, to map numerical group ID's to names. 


FILES 
/etc/group 


SEE ALSO 
newgrp(1), passwd(1), crypt(3C), passwd(5). 
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NAME 


holidays - defining holidays and prime time for accounting 


DESCRIPTION 


NOTES 


The accounting programs acctcon? and acctprc1 print usage data, dividing the data between 
prime and nonprime time. A holiday is nonprime time. The programs get the definition for prime 
and nonprime time and holidays from the file /usr/lib/acct/holidays. If this file is missing or the 
data is garbled or missing, the programs will use predefined values for the times and holidays. 


A sample /usr/lib/acct/holidays file: 


holidays = 0 44 163 188 329 330 349 350 364 
prime = 9:15 

nonprime = 17:00 

year = 1982 


The holidays are days of the year, starting with 0. They must be separated by white space, they 
must all fit on one line (maximum 200 characters), and only the first 30 holidays are used. 


The prime and nonprime variables define the starting and ending times, respectively, for the 
prime time. The times are given in hours and minutes separated by a colon as shown. 


The year is the current year. If this does not agree with the year as determined by the date com- 
mand, the acctcon1 and accprc1 programs will issue a mild protest. 


This command originates from Plexus; it is not part of standard SYSTEM Ill UNIX. 


SEE ALSO 
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acctcon1(1) and acctprc1(1) 
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NAME 





inittab - control information for init 


DESCRIPTION 
When a state is entered, init reads the file /etc/inittab. Lines in this file have the format: 


state:id:flags:command 


All lines in which the state field match init's current state are recognized. If a process is active 
under the same two character id as a recognized line, it may be terminated (signal 15), killed 
(signal 9), or both by including the flags t and k in the order desired. The signal is sent to all 
processes in the process group associated with the id. The command field is saved for later 
execution. The flag c requires the command to be continuously reinvoked whenever the pro- 
cess with that id dies. Otherwise the command is invoked a maximum of one time in the 
current state. 

Init ignores lines with the flag “o”. Note that init kills processes only when directed to by the “k” 
or “t’ flags. 


FILES 
/etc/inittab 
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NAME 
inode - format of an inode 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ino.n> 
DESCRIPTION | 
An i-node for a plain file or directory in a file system has the following structure defined by 
<sys/ino.h>. 
/* inode structure as it appears on a disk block. */ 
struct dinode 
{ 
ushort di_mode; /* mode and type of file */ 
short  di_nilink; /* number of links to file */ 
ushort di_uid; /* owner's user id */ 
ushort di_gid; /* owner's group id */ 
off_t di_size; /* number of bytes in file */ 
char di_addr{40]; /* disk block addresses */ 
time_t di_atime; /* time last accessed */ 
time_t di_mtime; //* time last modified */ 
time_t di_ctime; /* time created */ 
}: 
/* 
* the 40 address bytes: 
7 39 used; 13 addresses 
‘ of 3 bytes each. 
*/ 
For the meaning of the defined types off_t and time_t see types(7). 
FILES 
/ustr/include/sys/ino.h 
SEE ALSO | 
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stat(2), fs(5), types(7). 
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NAME 
mnttab - mounted file system table 
SYNOPSIS 
struct mnttab { 
char mt_dev[MNTPATH]; 
char mt_node[MNTPATH]; 
char mt_filsys[MNTPATH]; 
short mt_ro fig; 
time_t mt_time; 
}; 
DESCRIPTION 


Mnitab resides in directory /ete and contains a table of devices mounted by the mount(1M) and 
rmount(1M) commands. 


MNTPATH is currently 50. 


Each entry is 156 bytes in length; the first 50 bytes are the null-padded name of the place 
where the special file or remote directory is mounted; the next 50 bytes contain the node name 
of the remote system when rmount is invoked; the next 50 bytes represent the null-padded root 
name of the mounted special file or remote directory; the remaining 6 bytes contain the 
read/write permissions of the mounted special file or remote directory, and the date on which it 
was mounted. 


The maximum number of entries in mnttab is based on the system parameter NMOUNT located 
in /usr/sre/uts/ct/conf.c, which defines the number of allowable mounted special files. 


_ SEE ALSO 
mount(1M), rmount(1M). 
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NAME 


passwd - password file 


DESCRIPTION 


FILES 


Passwd contains for each user the following information: 


login name 

encrypted password 

numerical user ID 

numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 

program to use as Shell 


This is an ASCII file. Each field within each user's entry is separated from the next by a colon. 
The GCOS field is used only when communicating with that system, and in other installations 
can contain any desired information. Each user is separated from the next by a new-line. If the 
password field is null, no password is demanded; if the Shell field is null, the Shell itself is used. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have 
general read permission and can be used, for example, to map numerical user ID's to names. 


The encrypted password consists of 13 characters chosen from a 64 character alphabet (., /, 
0-9, A-Z, a-z), except when the password is null in which case the encrypted password is also 
null. Password aging is effected for a particular user if his encrypted password in the password 
file is followed by a comma and a non-null string of characters from the above alphabet. (Such a 
string must be introduced in the first instance by the super-user.) The first character of the age, 
M say, denotes the maximum number of weeks for which a password is valid. A user who 
attempts to login after his password has expired will be forced to supply a new one. The next 
character, m say, denotes the minimum period in weeks which must expire before the password 
may be changed. The remaining characters define the week (counted from the beginning of 
1970) when the password was last changed. (A null string is equivalent to zero.) M and m have 
numerical values in the range 0-63. If m = M = 0 (derived from the string . or ..) the user will 
be forced to change his password the next time he logs in (and the “age” will disappear from his 
entry in the password file). If m > M (signified, e.g., by the string ./) only the super-user will be 
able to change the password. 


/etc/passwd 


SEE ALSO 
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login(1), passwd(1), a64I(3C), crypt(3C), getpwent(3C), group(5). 
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NAME 





plot - graphics interface 3 = 


DESCRIPTION 
Files of this format are produced by routines described in pfot(3X) and are interpreted for vari- 
ous devices by commands described in tp/ot(1G). A graphics file is a stream of plotting instruc- 
tions. Each instruction consists of an ASCII letter usually followed by bytes of binary information. 
The instructions are executed in order. A point is designated by four bytes representing the x 
and y values; each value is a signed integer. The last designated point in an |, m, n, or p 
instruction becomes the “current point” for the next instruction. 


Each of the following descriptions begins with the name of the corresponding routine in p/ot(3X). 

m move: The next four bytes give a new current point. 

nm cont: Draw a line from the current point to the point given by the next four bytes. See 
tplot(1G). 

p point: Plot the point given by the next four bytes. 

| line: Draw a line from the point given by the next four bytes to the point given by the follow- 
ing four bytes. 

t label: Place the following ASCII string so that its first character falls on the current point. 
The string is terminated by a new-line. 

-@ erase: Start another frame of output. 


f linemod: Take the following string, up to a new-line, as the style for drawing further lines. 
The styles are “dotted”, “solid”, “longdashed”, “shortdashed”, and “dotdashed". Effective 
only for the -T4014 and -Tver options of tplot(1G) (Tektronix 4014 terminal and Versatec 
plotter). 


$ space: The next four bytes give the lower left corner of the plotting area; the following four 
give the upper right corner. The plot will be magnified or reduced to fit the device as closely 
as possible. 


Space settings that exactly fill the plotting area with unity scaling appear below for devices sup- 
ported by the filters of tolot(1G). The upper limit is just outside the plotting area. In every case 
the plotting area is taken to be square; points outside may be displayable on devices whose 
face is not square. | 





DAS! 300 space(0, 4096, 0, 4096); 
DAS! 300s space(0, 4096, 0, 4096); 
DAS! 450 space(0, 4096, 0, 4096); 


Tektronix 4014 space(0, 3120, 0, 3120); 
Versatec plotter § space(0, 2048, 0, 2048); 


SEE ALSO 
graph(1G), tplot(1G), plot(3X), gps(5), term(7). 
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NAME 





pnch - file format for card images 


DESCRIPTION 
The PNCH format is a convenient representation for files consisting of card images in an arbi- 
trary code. 


A PNCH file is a simple concatenation of card records. A card record consists of a single control 
byte followed by a variable number of data bytes. The control byte specifies the number (which 
must lie in the range 0-80) of data bytes that follow. The data bytes are 8-bit codes that consti- 
tute the card image. If there are fewer than 80 data bytes, it is understood that the remainder of 
the card image consists of trailing blanks. 
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NAME 
profile - setting up an environment at login time 


DESCRIPTION 
If your login directory contains a file named .profile, that file will be executed (via the shell's 
exec .profile) before your session begins; .profiles are handy for setting exported environment 
variables and terminal modes. If the file /ete/profile exists, it will be executed for every user 
before the .profile. The following example is typical (except for the comments): 


4 Make some environment variables global 

export MAIL PATH TERM LOGNAME 

# Set file creation mask 

umask 22 

#¢ Tell me when new mail comes in 
MAIL=/usr/mail/myname 

#. Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 

# Set terminal type 

echo "terminal: \c" 


read TERM 

case $TERM in 
300) stty cr2 nlO tabs; tabs;; 
300s) stty cr2 ni0 tabs; tabs;; 
450) stty cr2 ni0 tabs; tabs;; 
hp) stty crO nl0 tabs; tabs;; 
745|735) _ stty cr1 nl1 -tabs; TERM=745;; 
43) stty cr1 niO -tabs;; | 


4014|tek) sty crO nl0 -tabs ff1; TERM=4014; echo "\33;";; 
*) ~ echo "$TERM unknown";; 
esac 


FILES 
SHOME/.profile 
/etc/profile 


SEE ALSO 
env(1), login(1), mail(1), sh(1), stty(1), su(1), environ(7), term(7). 
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NAME 
sccsfile - format of SCCS file 
DESCRIPTION 
An SCCS file is an ASCIil file. It consists of six logical parts: the checksum, the delta table (con- 
tains information about each delta), user names (contains login names and/or numerical group 
IDs of users who may add deltas), flags (contains definitions of internal keywords), comments 
(contains arbitrary descriptive information about the file), and the body (contains the actual text 
lines intermixed with control lines). 
Throughout an SCCS file there are lines which begin with the ASCil SOH (start of heading) char- 
acter (octal 001). This character is hereafter referred to as the control character and will be 
represented graphically as @. Any line described below which is not depicted as beginning with 
the control character is prevented from beginning with the control character. 
Entries of the form DDDDD represent a five digit string (a number between 00000 and 99999). 
Each logical part of an SCCS file is described in detail below. 
Checksum 
The checksum is the first line of an SCCS file. The form of the line is: 
@hDDDDD 
The value of the checksum is the sum of all characters, except those of the first line. 
The @h provides a magic number of (octal) 064001. 
Delta table 
The delta table consists of a variable number of entries of the form: 
@s DDDDD/DDDDD/DDDDD 
@d <type> <SCCSID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 
@x DDDDD ... 
@g DDDDD ... 
@m <MR number> 
@c <comments > ... 
@e 
The first line (@s) contains the number of lines inserted/deleted/unchanged respectively. 
_ The second line (@d) contains the type of the delta (currently, normal: D, and removed: 
R), the SCCS ID of the delta, the date and time of creation of the delta, the login name 
corresponding to the real user ID at the time the delta was created, and the serial 
numbers of the delta and its predecessor, respectively. 
The @i, @x, and @g lines contain the serial numbers of deltas included, excluded, and 
ignored, respectively. These lines are optional. 
The @m lines (optional) each contain one MR number associated with the delta; the @c 
lines contain comments associated with the delta. 
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The @e line ends the delta table entry. 


User names 
The list of login names and/or numerical group IDs of users who may add deltas to the 
file, separated by new-lines. The lines containing these login names and/or numerical 
group IDs are surrounded by the bracketing lines @u and @U. An empty list allows any- 
one to make a delta. . 





Flags 
Keywords used internally (see admin(1) for more information on their use). Each flag 
line takes the form: 
@f <flag> <optional text> 
The following flags are defined: 
Of t <type of program > 
@fv <program name> 
Qf i 
@f b 
@fm <module name> 
@ff <floor> 
@fc <ceiling> 
@fd <defauit-sid> 
@f n 
@f j 
Qf | <lock-releases > 
@fq <user defined> 
The t flag defines the replacement for the identification keyword. The v flag controls 
prompting for MR numbers in addition to comments; if the optional text is present it 
defines an MR number validity checking program. The i flag controls the warning/error 
aspect of the “No id keywords” message. When the i flag is not present, this message 
is only a warning; when the i flag is present, this message will cause a “fatal” error (the 
file will not be gotten, or the delta will not be made). When the b flag is present the -b 
keyletter may be used on the gef command to cause a branch in the delta tree. The m 
flag defines the first choice for the replacement text of the scesfile.5 identification key- 
word. The f flag defines the “floor” release; the release below which no deltas may be 
added. The c flag defines the “ceiling” release; the release above which no deltas may 
be added. The d flag defines the default SID to be used when none is specified on a 
get command. The n flag causes delta to insert a “null” delta (a delta that applies no 
changes) in those releases that are skipped when a delta is made in a new release 
(e.g., when delta 5.1 is made after delta 2.7, releases 3 and 4 are skipped). The 
absence of the n flag causes skipped releases to be completely empty. The j flag 
causes get to allow concurrent edits of the same base SID. The I! flag defines a /ist of 
releases that are locked against editing (get(1) with the -e keyletter). The q flag defines 
the replacement for the identification keyword. 
Comments | 
Arbitrary text surrounded by the bracketing lines @t and @T. The comments section 
typically will contain a description of the file’s purpose. 
Body 


The body consists of text lines and control lines. Text lines don't begin with the control 
character, control lines do. There are three kinds of control lines: insert, delete, and 
end, represented by: 
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@!i DDDDD 
@D DDDDD 
@E DDDDD 


respectively. The digit string is the serial number corresponding to the delta for the con- 
trol line. 


SEE ALSO , 
admin(1), delta(1), get(1), prs(1). 
Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 
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NAME 
termcap - terminal capability data base 


SYNOPSIS 
/usr/pix/termcap 


DESCRIPTION 
Termcap is a database describing terminals, used, e.g., by vi(1) and curses(3). Termcap 
describes terminals by listing a set of their capabilities, and by describing how operations are 
performed. Padding requirements and initialization sequences are included in termcap. 


Entries in termcap consist of a number of fields, separated by ‘:’. The first entry for each termi- 
nal gives the names that are known for the terminal, separated by ‘|’ characters. The first name 
is always 2 characters long and is used by older version 6 systems, which store the terminal 
type in a 16 bit word in a systemwide data base. The second name is the most common abbre- 
viation for the terminal, and the last name should be a long name fully identifying the terminal. 
The second name should contain no blanks; the last name may contain blanks for readability. 


CAPABILITIES 
(P) padding may be specified 
(P*) padding may be based on the number of lines affected 


Name Type Pad? Description 
ae str (P) End alternate character set 
al str (P*) Add new blank line 





am __— bool Terminal has automatic margins 
as str (P) Start alternate character set 
be str Backspace if not “H 
bs bool Terminal can backspace with “H 
bt str (P) Back tab 
bw bool Backspace wraps from column 0 to last column 
CC str Command character in prototype if terminal settable 


cd = str_~=s- (P*)_~— Clear to end of display 
ce str (P) Clear to end of line 
ch str (P) Like cm but horizontal motion only, line stays same 


cl str (P*") Clear screen 
cm str (P) Cursor motion 
co num Number of columns in a line 


cr str (P*) Carriage return, (default “M) 
cs str (P) Change scrolling region (vt100), like cm 
CV str (P) Like ch but vertical only. 





da bool Display may be retained above 

dB num Number of millisec of bs delay needed 
db bool Display may be retained below 

dC num Number of millisec of cr delay needed 
dc str (P*) Delete character 

dF num Number of millisec of ff delay needed 
di str (P*) Delete line 

dm str Delete mode (enter) 

dN num Number of millisec of nl delay needed 
do str Down one line 

dT num Number of millisec of tab delay needed 
ed str End delete mode 

ei str End insert mode; give :ei=: if ic 

e0 str Can erase overstrikes with a blank 
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ff str 
he bool 
hd str 
ho str 
hu str 
hz str 
ic str 
if str 
im bool 
in bool 
Ip str 
is str 
kO-k9 str 
kb str 
kd str 
ke str 
kh str 
kl str 
kn num 
ko str 
kr str 
ks str 
ku str 
0-19 str 
li num 
il str 
ma str 
mi bool 
mi str 
mu str 
nc bool 
nd str 
ni str 
ns bool 
Os bool 
pc Str 
pt bool 
se str 
sf str 
Sg num 
SO str 
sr str 
ta str 
tc str 
te str 
ti str 
uc str 
ue str 
ug num 
ul bool 
up str 
us str 
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(P") 


(P) 


(P") 


(P*) 


(P) 


(P) 
(P) 
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Hardcopy terminal page eject (default “L) 
Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 
Hazeltine; can’t print “’s 

Insert character 

Name of file containing is 

Insert mode (enter); give :im=: if ic 
Insert mode distinguishes nulls on display 
Insert pad after character inserted 
Terminal initialization string 

Sent by other function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of keypad transmit mode 

Sent by home key 

Sent by terminal left arrow key 

Number of other keys 

Termcap entries for other non-function keys 
Sent by terminal right arrow key 


_ Put terminal in keypad transmit mode 


Sent by terminal up arrow key 

Labels on other function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 

Safe to move while in insert mode 

Memory lock on above cursor. 

Memory unlock (turn off memory lock). 

No correctly working carriage return (DM2500,H2000) 
Non-destructive space (cursor right) 

Newline character (default \n) 

Terminal is a CRT but doesn't scroll. 

Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 
End stand out mode 

Scroll forwards 

Number of blank chars left by so or se 

Begin stand out mode 

Scroll reverse (backwards) 

Tab (other than “I or with padding) 

Entry of similar terminal - must be last 

String to end programs that use cm 

String to begin programs that use cm 
Underscore one char and move past it 

End underscore mode 

Number of blank chars left by us or ue 
Terminal underlines even though it doesn't overstrike 
Upline (cursor up) 

Start underscore mode 
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vb str Visible bell (may not move cursor) 

ve str Sequence to end open/visual mode 

vs str Sequence to start open/visual mode 

xb bool Beehive (f1=escape, f2=ctrl C) 

xn bool A newline is ignored after a wrap (Concept) 

xr bool Return acts like ce \r \n (Delta Data) 

xs bool Standout not erased by writing over it (HP 2647) 

xt bool Tabs are destructive, magic so char (Teleray 1061) 
A Sample Entry 


The following entry, which describes the Concept-100, is among the more complex entries in the 
termcap file as of this writing. (This particular concept entry is outdated, and is used as an 
example only.) 


cl | c100 | concept100: is=\EU\Ef\E7\ES\E8\El\ENH\EK\E\200\E08&\200: \ 
‘al=3"\E" R:am:bs: cd=16"\E C:ce=16\E'S: cl—=2" “Licm=\Ea%-+ %-+ :co#80:\ 
:>dc=16\E"A:dil=3*\E"B:ei=\E\200:e0:im=\E’P:in:ip=16":li424:mi:nd=\E=:\ 
'se=\Ed\Ee: so=—\ED\EE:ta—8\t:ul:up=\E;:vb==\Ek\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last character of a line, and empty 
fields may be included for readability (here between the last field on a line and the first field on 
the next). Capabilities in termcap are of three types: (1) Boolean capabilities, which indicate 
that the terminal has some particular feature; (2) numeric capabilities giving the size of the ter- 
minal or the size of particular delays; and (3) string capabilities, which give a sequence that can 
be used to perform particular terminal operations. 


Types of Capabilities 





_ All capabilities have two letter codes. For instance, the fact that the Concept has automatic mar- 
gins (i.e. an automatic return and linefeed when the end of a line is reached) is indicated by the 
capability am. Hence the description of the Concept includes am. Numeric capabilities are fol- 
lowed by the character ‘#' and then the value. Thus co, which indicates the number of columns 
the terminal has, equals ‘80’ for the Concept. 


Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the 
two-character code, an ‘=’, and then a string ending at the next following ‘:’. A delay in mil- 
liseconds may appear after the ‘=' in such a capability, and padding characters are supplied by 
the editor after the remainder of the string is sent to provide this delay. The delay can be either 
a integer, e.g. ‘20’, or an integer followed by a ‘’, i.e. 3". A ™ indicates that the padding 
required is proportional to the number of lines affected by the operation, and the amount given 
is the per-affected-unit padding required. When a ™’ is specified, it is sometimes useful to give 
a delay of the form ‘3.5’ specify a delay per unit to tenths of milliseconds. 


A number of escape sequences are provided in the string valued capabilities for easy encoding 
of characters there. A \E maps to an EScaPE character, “x maps to a control-x for any appropri- 
ate x, and the sequences \n \r \t \b \f give a newline, return, tab, backspace and formfeed. 
Finally, characters may be given as three octal digits after a \, and the characters * and \ may 
be given as \* and \\. If it is necessary to place a : in a capability it must be escaped in octal 
as \072. If it is necessary to place a null character in a string capability it must be encoded as 
\200. The routines that deal with termcap use C strings, and strip the high bits of the output 
very late so that a \200 comes out as a \000 would. 
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Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is to imitate the description of a similar terminal in termcap and then build 
up a description gradually, using partial descriptions with ex to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the fermcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set the environment 
variable TERMCAP to a pathname of a file containing the description you are working on and 
the editor will look there rather than in /efc/termcap. TERMCAP can also be set to the termcap 
entry itself to avoid reading the file when starting up the editor. (This only works on version 7 
systems.) 


Basic capabilities 


The number of columns on each line for the terminal is given by the co numeric capability. If the 
terminal is a CRT, then the number of lines on the screen is given by the li capability. If the ter- 
minal wraps around to the beginning of the next line when it reaches the right margin, then it 
should have the am capability. If the terminal can clear its screen, then this is given by the cl 
string capability. If the terminal can backspace, then it should have the bs capability, unless a 
backspace is accomplished by a character other than “H (ugh) in which case you should give 
this character as the be string capability. If it overstrikes (rather than clearing a position when a 
character is struck over) then it should have the os capability. 


A very important point here is that the local cursor motions encoded in termcap are undefined at 
the left and top edges of a CAT terminal. The editor will never attempt to backspace around the 
left edge, nor will it attempt to go up locally off the top. The editor assumes that feeding off the 
bottom of the screen will cause the screen to scroll up, and the am capability tells whether the 
cursor sticks at the right edge of the screen. If the terminal has switch selectable automatic mar- 
gins, the termcap file usually assumes that this is on, i.e. am. 


These capabilities suffice to describe hardcopy and glass-tty terminals. Thus the model 33 tele- 
type is described as 


t3 | 33 | tty33:co#72:0s 
while the Lear Siegler ADM-3 is described as 

cl | adm3 131 Isi adm3:am:bs:cl="Z:li#424:co#80 
Cursor addressing 


Cursor addressing in the terminal is described by a cm string capability, with printf(3s) like 
escapes %x in it. These substitute to encodings of the current line or column position, while 
other characters are passed through unchanged. If the cm string is thought of as being a func- 
tion, then its arguments are the line and then the column to which motion is desired, and the % 
encodings have the following meanings: 





%d as in printf, 0 origin 

%2 like %2d 

%o3 like %3d 

%. like %c 

%-+-x adds x to value, then %. 

%>xy if value > x adds y, no output. 

Yr reverses order of line and column, no output 

%i increments line/column (for 1 origin) 

%% gives a single % 

%N exclusive or row and column with 0140 (DM2500) 
%B BCD (16*(x/10)) + (x%10), no output. 

%D —_— Reverse coding (x-2*(x%16)), no output. (Delta Data). 
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Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&a12c03Y 
padded for 6 milliseconds. Note that the order of the rows and columns is inverted here, and 
that the row and column are printed as two digits. Thus its cm capability is 

— CM=6\ES%r%2c%2ZY. The Microterm Act-Iv needs the current row and column sent preceded 
by a “T, with the row and column simply encoded in binary, cm='T%.%.. Terminals which use 
%. need to be able to backspace the cursor (bs or bc), and to move the cursor up one line on 
the screen (up introduced below). This is necessary because it is not always safe to transmit 
\t, \n “D and \r, as the system may change or discard them. 


A final example is the LS! ADM-3a, which uses row and column offset by a blank character, thus 
cm=\E=%+ %-+. 


Cursor motions 


— |f the terminal can move the cursor one position to the right, leaving the character at the current 
position unchanged, then this sequence should be given as nd (non-destructive space). If it can 
move the cursor up a line on the screen in the same column, this should be given as up. If the 
terminal has no cursor addressing capability, but can home the cursor (to very upper left corner 
of screen) then this can be given as ho; similarly a fast way of getting to the lower left hand 
corner can be given as Il; this may involve going up with up from the home position, but the edi- 
tor will never do this itself (unless Il does) because it makes no assumption about the effect of 
moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the line, leaving the cursor where 
it is, this should be given as ce. If the terminal can clear from the current position to the end of 
the display, then this should be given as cd. The editor only uses ed from the first column of a 
line. 


insert/delete line 


lf the terminal can open a new blank line before the line where the cursor is, this should be 
given as al; this is done only from the first position of a line. The cursor must then appear on the 
newly blank line. If the terminal can delete the line which the cursor is on, then this should be 
given as dil; this is done only from the first position on the line to be deleted. If the terminal can 
scroll the screen backwards, then this can be given as sb, but just al suffices. If the terminal 
can retain display memory above then the da capability should be given; if display memory can 
be retained below then db should be given. These let the editor understand that deleting a line 
on the screen may bring non-blank lines up from below or that scrolling back with sb may bring 
down non-blank lines. 





Insert/delete character 


There are two basic kinds of intelligent terminals with respect to insert/delete character that can 
be described using termcap. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off the end of the line rigidly. Other termi- 
nals, such as the Concept 100 and the Perkin Elmer Owl, make a distinction between typed and 
untyped blanks on the screen, shifting upon an insert or delete only to an untyped blank on the 
screen which is either eliminated, or expanded to two untyped bianks. You can find out which 
kind of terminal you have by clearing the screen and then typing text separated by cursor 
motions. Type abc def using local cursor motions (not spaces) between the abc and the def. 
Then position the cursor before the abc and put the terminal in insert mode. If typing characters 
causes the rest of the line to shift rigidly and characters to fall off the end, then your terminal 
does not distinguish between blanks and untyped positions. If the abc shifts over to the def 
which then move together around the end of the current line and onto the next as you insert, 
you have the second type of terminal, and should give the capability in, which stands for insert 
null. If your terminal does something different and unusual then you may have to modify the 
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editor to get it to use the insert mode your terminal defines. All terminals we have seen have an 
insert mode falling into one of these two classes. 


The editor can handle both terminals that have an insert mode, and terminals that send a simple 
sequence to open a biank position on the current line. Give as im the sequence to get into 
insert mode, or give it an empty value if your terminal uses a sequence to insert a blank posi- 
tion. Give as ei the sequence to leave insert mode (give this, with an empty value also if you 
gave im so). Now give as ic any sequence needed to be sent just before sending the character 
to be inserted. Most terminals with a true insert mode will not give ic, terminals which send a 
sequence to open a screen position should give it here. (Insert mode is preferable to the 
sequence to open a position on the screen if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a string option). Any other sequence which 
may need to be sent after an insert of a single character may also be given in ip. 


It is occasionally necessary to move around while in insert mode to delete characters on the 
same line (e.g. if there is a tab after the insertion position). If your terminal allows motion while 
in insert mode you can give the capability mi to speed up inserting in this case. Omitting mi will 
affect only speed. Some terminals (notably Datamedia’s) must not have mi because of the way 
their insert mode works. 


Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and de 
to delete a single character while in delete mode. 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode these can be given as so and 
se respectively. If there are several flavors of standout mode (such as inverse video, blinking, 
or underlining - half bright is not usually an acceptable standout mode unless the terminal is in 
inverse video mode constantly) the preferred mode is inverse video by itself. If the code to 
change into or out of standout mode leaves one or even two biank spaces on the screen, as the 
TVI 912 and Teleray 1061 do, this is acceptable, and although it may confuse some programs 
slightly, it can't be helped. 


Codes to begin underlining and end underlining can be given as us and ue respectively. If the 
terminal has a code to underline the current character and move the cursor one space to the 
right, such as the Microterm Mime, this can be given as uc. (If the underline code does not 
move the cursor to the right, give the code followed by a nondestructive space.) 


If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as vb; it must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of ex, this can be given as vs and ve, sent at the 
start and end of these modes respectively. These can be used to change, e.g., from a underline 
to a block cursor and back. 





If the terminal needs to be in a special mode when running a program that addresses the cursor, 
the codes to enter and exit this mode can be given as ti and te. This arises, for example, from 
terminals like the Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor addressing, a one screen- 
sized window must be fixed into the terminal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are erasable 
with a blank, then this should be indicated by giving eo. 


Keypad 


If the terminal has a keypad that transmits codes when the keys are pressed, this information 
can be given. Note that it is not possible to handle terminals where the keypad only works in 
local (this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to 
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transmit or not transmit, give these codes as ks and ke. Otherwise the keypad is assumed to 
always transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and home 
keys can be given as kl, kr, ku, kd, and kh respectively. If there are function keys such as f0, 
fi, ..., 9, the codes they send can be given as kO, k1, ..., k9. If these keys have labels other 
than the default f0 through f9, the labels can be given as 10, I1, ..., 19. If there are other keys 
that transmit the same code as the terminal expects for the corresponding function, such as 
clear screen, the termcap 2 letter codes can be given in the ko capability, for example, 
-ko=—cl,|l,sf,sb:, which says that the terminal has clear, home down, scroll down, and scroll up 
keys that transmit the same thing as the cl, Il, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which have single character arrow 
keys. It is obsolete but still in use in version 2 of vi, which must be run on some minicomputers 
due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists of 
groups of two characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for kl, j for kd, k 
for ku, | for kr, and H for kh. For example, the mime would be :ma="Kj Zk’ XI: indicating 
arrow keys left ("H), down (“K), up ("Z), and right (“X). (There is no home key on the mime.) 


Miscellaneous 
If the terminal requires other than a null (zero) character as a pad, then this can be given as pe. 


If tabs on the terminal require padding, or if the terminal uses a character other than “I to tab, 
then this can be given as ta. 


so» 


Hazeltine terminals, which don't allow *’ characters to be printed should indicate hz. Datamedia 
terminals, which echo carriage-return linefeed for carriage return and then ignore a following 
linefeed should indicate nc. Early Concept terminals, which ignore a linefeed immediately after 
an am wrap, should indicate xn. If an erase-eol is required to get rid of standout (instead of 
merely writing on top of it), xs should be given. Teleray terminals, where tabs turn all charac- 
ters moved over to blanks, should indicate xt. Other specific terminal problems may be 
corrected by adding more capabilities of the form xx. 


Other capabilities include is, an initialization string for the terminal, and if, the name of a file 
containing long initialization strings. These strings are expected to properly clear and then set 
the tabs on the terminal, if the terminal has settable tabs. If both are given, is will be printed 
before if. This is useful where if is /usr/lib/tabset/std but ts clears the tabs first. 


. Similar Terminals 


FILES 


If there are two very similar terminals, one can be defined as being just like the other with cer- 
tain exceptions. The string capability te can be given with the name of the similar terminal. 
This capability must be /ast and the combined length of the two entries must not exceed 1024. 
Since termlib routines search the entry from left to right, and since the tc capability is replaced 
by the corresponding entry, the capabilities given at the left override the ones in the similar ter- 
minal. A capability can be canceled with xx@ where xx is the capability. For example, the entry 


hn | 2621nl:ks@:ke@:tc=2621: 


defines a 2621nlI that does not have the ks or ke capabilities, and hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or for 
different user preferences. 


/etc/termcap __ file containing terminal descriptions 


SEE ALSO 
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ex(1), curses(3), termlib(3), tset(1), vi(1), ul(1), more(1). 
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NOTES 
The Plexus version of termcap is based on the one developed at the University of California at 
Berkeley. 


BUGS 
Ex allows only 256 characters for string capabilities, and the routines in termcap(3) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines) 
may not exceed 1024. 


The ma, vs, and ve entries are specific to the vi program. 





Not all programs support all entries. There are entries that are not supported by any program. 
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NAME 
tp - magnetic tape format 


DESCRIPTION 
The command fp(1) dumps files to and extracts files from magtape. 


Block zero contains a copy of a stand-alone bootstrap program; see tapeboot(8). 


Blocks 1 through 62 contain a directory of the tape. There are 496 entries in the directory; 8 
entries per block; 64 bytes per entry. Each entry has the following format: 





struct tpent { 

char pathnam(32]; 

short mode; 

char uid; 

char uid; 

char gid; 

char = spare; 

char _ size0; 

short size2; 

long __itime; 

short tapea; /*x tape address +/ 

short unused[8}; 

short cksum; /x check sum +/ 
} 


The pathnam entry is the path name of the file when put on the tape. If the path name starts 
with a zero word, the entry is empty. It is at most 32 bytes long and ends in a null byte. Mode, 
uid, gid, the sizes and time modified are the same as described under i-nodes (fs(5)). The 
tape address is the tape block number of the start of the contents of the file. Every file starts on 
a block boundary. The file occupies (size+-1023)/1024 blocks of continuous tape. The check- 
sum entry has a value such that the sum of the 32 words of the directory entry is zero. 


Blocks 63 on are available for file storage. 





A fake entry has a size of zero. See tp(1). 


SEE ALSO | 
cpio(1), tp(1), fs(5), tapeboot(8). 
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NAME 
ttytype - data base of terminal types by port 


SYNOPSIS 
/ete/ttytype 


DESCRIPTION 
Ttytype is a database containing, for each TTY port on the system, the kind of terminal that is 
attached to it. The terminal kinds are from the names listed in termcap(5). Each port descrip- 
tion occupies one line. The line contains the terminal kind, a space, and the name of the TTY, 
minus the /dev prefix. A sample ttytype file looks like this: 


vt100 console 
adm3a ttyO 
vt100 tty1 
vt52 tty2 
vt100 tty3 
vt100 tty4 
dm1520 tty5 
vt100 tty6 
vt100 tty7 


This information is used by tset(1) and /fogin(1) to initialize the TERM variable at login time. 


SEE ALSO 
tset(1), login(1). 
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NAME | 
utmp, wimp - utmp and wtmp entry format 


DESCRIPTION 
The files utmp and wtmp hold user and accounting information for use by commands such as 
who(1), acctcon? (see acctcon(1M)), and fogin(1). They have the following structure, as 
defined by <utmp.h>: 


struct utmp 
char —_ut_line[8]; /x tty name x/ 
char ut_name[8]; /x login name x/ 
long _ut_time; /x time on +/ 
} 
FILES 
/etc/utmp 
/usr/adm/wtmp 
/usr/include/utmp.h 
SEE ALSO 


acctcon(1M), login(1), who(1), write(1). 
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NAME 


vtconf - configuration file for the NOS Virtual Terminal facility 


DESCRIPTION 
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The file /usr/lib/nos/vtconf configures the Virtual Terminal Facility of the Plexus Network 
Operating System (NOS). 


The major device number of a virtual TTY is 22. Plexus by default creates eight virtual terminal 
devices: four /dev/vitty devices, which are used by remote systems for logging in to the local 
system; and four /dev/vtty devices, which are used by the local system to connect to remote 
systems. There is no set limit to the number of virtual TTYs you can create. You can call them 
whatever you like. 


NOS uses the file /usr/lib/nos/vtconf to determine what virtual connections are permitted on 
what lines. The file is read only at initialization time when the system is booted. Hence to 
locally reconfigure virtual TTYs, the system must be rebooted. An error message is generated if 
the file cannot be located. 


Comments may be placed in viconf by preceding them with a pound sign (#). New lines may 
be escaped with a backslash ("\"). 


For a vitty, the entries in vtconf have the form | 
<vtid>[-<vtid>]:<local nodename >[: <remote nodename >, <remote nodename > vevel 


where "vtid" is the minor device number of the virtual TTY device, "local nodename" is the 
nodename of the system where this vitty is located, and "remote nodename" is the nodename 
of systems that are permitted to use this virtual TTY for logging in. Nodenames are limited to 9 
characters in length. No entry in the third field or the keyword "all" mean that any remote sys- 
tem may use this virtual TTY. For example, the line 


0-5:local 

means that any remote system may use vittys 0-5. The line 
10:local:remote2 

means that vitty2 is dedicated for use by the remote system "remote2". 

For a vity, the entries in vtconf have the form 
<vtid>[-<vtid>]:<remote nodename> 


where "vtid" is the minor device number of the virtual TTY device, and "remote nodename" is 
the nodename of the system to which this virtual terminal is logically connected. For example, if 
virtual terminal vttyO has the minor device number 0 and is logically connected to the system 
"remotei", the vtconf entry for vttyO would read 


O:remote1 


This means that vttyO is connected to the system "remote1". Each vtty may be logically con- 
nected to one and only one remote system. 
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EXAMPLE 
If /dev contains these lines | 


-crw-rw-rw- 1 root) 3=22, 5 Dec 11 15:14 glenvity 
crw-rw-rw- 1 root) 3=.22, 3 Dec 11 15:14 gregvtty 
crw-rw-rw- 1 root) =. 22,_:-6 Jan 28 15:57 guestvity 
crw-rw-rw- 1 root) 3=—.22,_:~4 Dec 11 15:14 jsevttty 
crw-rw-rw- 1 root =. 22,_—«1:~; Feb 11 14:06 montevtty 
crw-rw-rw- 1 root)3=—s. 22,_: 2 Feb 14 14:13 pafvtty 
crw-rw-rw- 1 root =. 22, - 0 Jan 20 16:28 sandyvtty 
crw--w--w- 1 root 22, 12 Feb 15 10:37 vittyO 
crw--w--w- 1 root 22, 13 Feb 14 17:58 vitty1 
crw--w--w- 1 root) 22, 14 Jan 11 15:27 vitty2 
crw--w--w- 1 root 22, 15 Jan 10 18:26 vitty3 
crw--w--w- 1 root 22, 16 Dec 18 21:08 vitty4 


‘there are seven vtty devices (minor device numbers 0-6), and five vitty devices (minor device 
numbers 12-16); and the vtconf file might look like this: 


O:remotet 
1:remote2 
2-6:remote3 
12:local:remote1 
13-14:local:remote2 
15-16:local 


The first three lines apply to vity devices. The first line means that the device sandyvity (minor 
device number 0) must be used to connect with the remote system "remote1". The second line 
means the device montevity (minor device number 1) must be used to connect with the remote 
system "remote2". The third line means any of the devices pafvity, gregvtty, Sevity, glenvtty, 
or guestvtty may be used to connect with the remote system "remote3". 


The rest of the lines apply to vitty devices. The fourth line means that the device vittyO may 
receive logins from remote system "remotei" only; the fifth line says that devices vitty? and 
vitty2 will receive logins from the remote system "remote2" only. The sixth line says that the 
rest of the vitty devices will receive logins from any remote system. 


‘DIAGNOSTICS 
bad or duplicate line in vtconf line count = <line where error occurred > 
Last part is <characters in line to the right of the error> 
The input line contains a parse error. A parse error occurs when there is a duplicate line, or the 
same vity is connected to more than one remote system, or the same virtual terminal is 
declared to be both a vity and a vitty. 





cannot build host list for VT: no space in siocbuf 
The buffer for the storage of host names has overflowed. 


Max no. vity’s: <number of new entries that have been added to parse table> 

viconf lists more which are ignored 

The parser ran out of space trying to update vtconf. It was able to add some new entries, but 
found it could no longer access the old ones. This means there are too many virtual terminal 
devices. 
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NAME 





intro - introduction to games 


DESCRIPTION 
This section describes the recreational and educational programs found in the directory 
/usr/games. A suggested procedure is to disallow their use during business hours by means of 
cron(1M). 

NOTES 


Plexus adds fish. The following games are not currently supported: chess, maze, quiz, reversi, 
and sky. 
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NAME 


arithmetic - provide drill in number facts 


SYNOPSIS 


/usr/games/arithmetic [ -++-x/ ] [ range ] 


DESCRIPTION 
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Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the 
answer is correct, it types back “Right!”, and a new problem. If the answer is wrong, it replies 
“What?”, and waits for another answer. Every twenty problems, it publishes statistics on 
correctness and the time required to answer. | 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be generated; ++, -, x, and / 
respectively cause addition, subtraction, multiplication, and division problems to be generated. 
One or more characters can be given; if more than one is given, the different types of problems 
will be mixed in random order; default is +--. 


Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and 
quotients will be less than or equal to the value of range. Default range is 10. 


At the start, all numbers less than or equal to range are equally likely to appear. If the respon- 
dent makes a mistake, the numbers in the problem which was missed become more likely to 
reappear. 


As a matter of educational philosophy, the program will not give correct answers, since the 
learner should, in principle, be able to calculate them. Thus the program is intended to provide 
drill for someone just past the first learning stage, not to teach number facts de novo. For 
almost all users, the relevant statistic should be time per problem, not percent correct. 
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NAME 


back - the game of backgammon 


SYNOPSIS 


fusr/games/back 


DESCRIPTION 


FILES 


BUGS 


Page 1 


Back is a program which provides a partner for the game of backgammon. It is designed to 
play at three different levels of skill, one of which you must select. In addition to selecting the 
opponent's level, you may also indicate that you would like to roll your own dice during your 
turns (for the superstitious players). You will also be given the opportunity to move first. The 
practice of each player rolling one die for the first move is not incorporated. 


The points are numbered 1-24, with 1 being white’s extreme inner table, 24 being brown's inner 
table, O being the bar for removed white pieces and 25 the bar for brown. For details on how 
moves are expressed, type y when back asks “Instructions?” at the beginning of the game. 
When back first asks “Move?”, type ? to see a list of move options other than entering your 
numerical move. 


When the game is finished, back will ask you if you want the log. If you respond with y, back 
will attempt to append to or create a file back.log in the current directory. 


/usr/games/lib/backrules rules file 
‘tmp/b« log temp file 
back.log log file 


The only level really worth playing is “expert”, and it only plays the forward game. 

Back will complain loudly if you attempt to make too many moves in a turn, but will become 
very silent if you make too few. 

Doubling is not implemented. 

Back does not provide instructions. 
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NAME 





bj - the game of black jack 


SYNOPSIS 
/usr/games/bj 


DESCRIPTION 
Bj is a serious attempt at simulating the dealer in the game of black jack (or twenty-one) as 
might be found in Reno. The following rules apply: 


The bet is $2 every hand. 


A player “natural” (black jack) pays $3. A dealer natural loses $2. Both dealer and player 
naturals is a “push” (no money exchange). 


lf the dealer has an ace up, the player is allowed to make an “insurance” bet against the 
chance of a dealer natural. If this bet is not taken, play resumes as normal. If the bet is 
taken, it is a side bet where the player wins $2 if the dealer has a natural and loses $1 if 
the dealer does not. 


If the player is dealt two cards of the same value, he is allowed to “double”. He is allowed 
to play two hands, each with one of these cards. (The bet is doubled also; $2 on each 
hand.) 


if a dealt hand has a total of ten or eleven, the player may “double down”. He may double 
the bet ($2 to $4) and receive exactly one more card on that hand. 


Under normal play, the player may “hit” (draw a card) as long as his total is not over 
twenty-one. If the player “busts” (goes over twenty-one), the dealer wins the bet. 


When the player “stands” (decides not to hit), the dealer hits until he attains a total of 
seventeen or more. If the dealer busts, the player wins the bet. 





If both player and dealer stand, the one with the largest total wins. A tie is a push. = 


The machine deals and keeps score. The following questions will be asked at appropriate 
times. Each question is answered by y followed by a new-line for “yes”, or just new-line for 
“no”. 


? (means, “do you want a hit?”) 
Insurance? 
Double down? 


Every time the deck is shuffled, the dealer so states and the “action” (total bet) and “standing” 
(total won or lost) is printed. To exit, hit the interrupt key (DEL) and the action and standing will 
be printed. 
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NAME 





craps - the game of craps 


SYNOPSIS 
/usr/games/craps 


DESCRIPTION 
Craps is a form of the game of craps that is played in Las Vegas. The program simulates the 
roller, while the user (the player) places bets. The player may choose, at any time, to bet with 
the roller or with the House. A bet of a negative amount is taken as a bet with the House, any 
other bet is a bet with the roller. 


The player starts off with a “bankroll” of $2,000. 
The program prompts with: 
bet? 


The bet can be all or part of the player's bankroll. Any bet over the total bankroll is rejected and 
the program prompts with “bet?” until a proper bet is made. 


Once the bet is accepted, the roller throws the dice. The following rules apply (the player wins 
or loses depending on whether the bet is placed with the roller or with the House; the odds are 
even). The first roll is the roll immediately following a bet. 


1. On the first roll: 
7 or 11 wins for the roller; 
2, 3, or 12 wins for the House; 
any other number is the point, roll again (Rule 2 applies). 





2. On subsequent rolls: 
point roller wins; 
7 House wins; 
any other number roll again. 


If a player loses the entire bankroll, the House will offer to lend the player an additional $2,000. 
The program will prompt: 


marker? 
A “yes” (or “y”) consummates the loan. Any other reply terminates the game. 


If a player owes the House money, the House reminds the player, before a bet is placed, how 
many markers are outstanding. 


if, at any time, the bankroll of a player who has outstanding markers exceeds $2,000, the House 
asks: 


Repay marker? 


A reply of “yes” (or “y”) indicates the player's willingness to repay the loan. If only 1 marker is 
outstanding, it is immediately repaid. However, if more than 1 marker are outstanding, the 
House asks: 


How many? 


markers the player would like to repay. If an invalid number is entered (or just a carriage 
return), an appropriate message is printed and the program will prompt with “How many?” until 
a valid number is entered. 
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lf a player accumulates 10 markers (a total of $20,000 borrowed from the House), the program 
informs the player of the situation and exits. 





Should the bankroll of a player who has outstanding markers exceed $50,000, the tota/ amount 
_Of money borrowed will be automatically repaid to the House. 


Any player who accumulates $100,000 or more breaks the bank. The program then prompts: 
New game? | 
to give the House a chance to win back its money. 


Any reply other than “yes” is considered “no” (except in the case of “bet?” or “How many?’). 
To exit, send an interrupt (break), DEL, or control-D. The program will indicate whether the 
player won, lost, or broke even. 


MISCELLANEOUS | 
The random number generator for the die numbers uses the seconds from the time of day. 


Depending on system usage, these numbers, at times, may seem strange but occurrences of 
this type in a real dice situation are not uncommon. 
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NAME 





fish - the game of fish 


SYNOPSIS 
/usr/games/fish 


DESCRIPTION 

Fish simulates the children’s card game. The player is dealt seven cards; the computer also 
has a hand of seven cards, which the player never sees. The players take turns asking each 
other if each has a certain card; e.g., "Do you have any 8's?" The player asking must have at 
least one of the card in question. If the other player has one or more of the cards, he must 
surrender them; otherwise, he draws one from the deck. The goal is to accumulate all four of 
each card, i.e., all the aces, all the 2's, all the 3’s, and so on. Whoever has the most complete 
sets wins. 
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NAME 





hangman - guess the word 
SYNOPSIS 
/usr/games/hangman [ arg ] 


DESCRIPTION 
Hangman chooses a word at least seven letters long from a dictionary. The user is to guess 
letters one at a time. , 
The optional argument arg names an alternate dictionary. 
FILES | 
/usr/lib/w2006 


BUGS 
Hyphenated compounds are run together. 
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NAME 

moo - guessing game 
SYNOPSIS 

/usr/games/moo 
DESCRIPTION 


Moo is a guessing game imported from England. The computer picks a number consisting of 
four distinct decimal digits. The player guesses four distinct digits being scored on each guess. 
A “cow” is a correct digit in an incorrect position. A “bull” is a correct digit in a correct position. 
The game continues until the player guesses the number (a score of four bulls). 
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TTT(6) | TIT (6) 


NAME 
ttt - tic-tac-toe 
SYNOPSIS 
/usr/games’/ttt 
DESCRIPTION 


Ttt is the X and O game popular in the first grade. This is a learning program that never makes 
the same mistake twice. | 





Although it learns, it learns slowly. It must lose nearly 80 games to completely know the game. 
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WUMP(6) | (PDP-11 only) WUMP(6) 





NAME 
wump - the game of hunt-the-wumpus 

SYNOPSIS 
/usr/games/wump 

DESCRIPTION 
Wump plays the game of “Hunt the Wumpus.” A Wumpus is a creature that lives in a cave with 
several rooms connected by tunnels. You wander among the rooms, trying to shoot the 
Wumpus with an arrow, meanwhile avoiding being eaten by the Wumpus and falling into Bot- 
tomless Pits. There are also Super Bats which are likely to pick you up and drop you in some 
random room. 
The program asks various questions which you answer one per line; it will give a more detailed 
description if you want. 
This program is based on one described in People’s Computer Company, 2, 2 (November 
1973). 7 

BUGS 


It will never replace Adventure. 
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NAME 
intro - introduction to miscellany 


DESCRIPTION 
This section describes miscellaneous facilities such as macro packages, character set tables, 
etc. 


NOTES | 
Plexus continues to provide the ms macro package. 
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NAME 


ascii - map of ASCII character set 
SYNOPSIS 


ASCII(7) 





cat /usr/pub/ascii 


DESCRIPTION 


Ascii is a map of the ASCII character set, giving both octal and hexadecimal equivalents of each 
character, to be printed as needed. It contains: 





j000 nul |001 soh {002 stx |003 etx [004 eot {005 enq |006 ack {007 bel | 
1010 bs (011 ht (012 ni |013 vt 4014 np 1015 cr 1016 so |017 si | 
{020 die |021 dc1 {022 dc2 |023 dc3 |024 dc4 {025 nak |026 syn |027 etb | 
{030 can |031 em {032 sub |033 esc [034 fs {035 gs [036 rs |037 us | 
1040 sp 1041 ! 4042" (043 4% (044$ (045% |046& 4047 ” | 
1050 ( (051) 1052 * |053+ 1054, |055- {056. 057 / | 
1060 0 1061 1 (0622 (10633 {0644 |0655 |j0666 {|0677 | 
{070 8 }071 9 j072 : (073 ; }074 << |075= |076> {077 ? ; 
1100 @ |101 A |102B {103 C |104D |j108E 4106 F  |107G | 
1110 H [111 1 1112 J 1113 K 114 L 1115 M 4116 N 11170 | 
(1120 P 4121Q  |122R 4123S (1247 |125U |126V |127W_ | 
1190 X 4131 Y (1922 1939 [ |1134\- 1185] 11396" 1137. | 
1140 § (141 a |142b (143 cc |144d 1145 e [146 f |147g | 
1150 h 4151 i 4152 j (153 k [1541 (155m |156n 41570 | 
11460 p (161 q (162 r |163 s |164t (165 u |166v |167wWw | 
170 x W171 y (1722 (1739 { 11741 1175 } (176 ~ 1177 del | 
{| 00 nul | 01 soh | 02 stx | 03 etx | 04 eot | 05 enq | 06 ack | 07 bel | 
|} 08 bs | O9 ht | Oanl | Obvt | Oc np | Odcr | Oe so | Of si | 
1 10 dle | 11 dc1 | 12 dc2 | 13 dc3 | 14 dc4 | 15 nak | 16 syn | 17 etb | 
| 18 can | 19 em | 1a sub | 1b esc | 1¢ fs | 1d gs | le rs | 1f us | 
120sp | 21! | 22" |2e 1248 | 25% | 26& 4277 | 
(28( 129) j|2a* | 2+ ||]2¢, |J2d- f{ 2e. | 2f / | 
1300 1|311 | 322 1333 |344 |355 | 366 {377 | 
1388 |399 |3a: {3b; |3ce¢ | 3d= | Sed |{3F? | 
140@ 141A | 428 (430 [44D |45E |46F |47G | 
148H 4491 |4aJ | 40K |[{4cL | 4dM | 4e€N | 4F0O | 
150P |;51Q |52R 1538S {| 547T | 55U | SV | STW | 
158X |59Y |S5aZ |5b[ {S5c\ [5d] |5e° |5t_. | 
160% {61a |62b | 63c¢ | 64d |65e | 66f 167g | 
(68h | 69 i | 6a j | 6bk {| 6c Il | 6dm | 6en | 6fo | 
1170p {71q | 72r |73s | 74t | 75u [| 7v | 77we | 
178x |79y |7az |7b{ | 7c | | 7d} | 7e~ | 7f del | 
FILES 
/usr/pub/ascii 
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NAME 
environ - user environment 
DESCRIPTION 

An array of strings called the “environment” is made available by exec(2) when a process 

begins. By convention, these strings have the form “name=value”. The following names are 

used by various commands: 

PATH The sequence of directory prefixes that sh(1), time(1), nice(1), nohup(1), etc., apply 
in searching for a file known by an incomplete path name. The prefixes are 
separated by colons (:). Login(1) sets PATH=:/bin:/usr/bin. 

HOME Name of the user’s login directory, set by login(1) from the password file passwd(5). 

TERM The kind of terminal for which output is to be prepared. This information is used by 
commands, such as mm(1) or tpfot(1G), which may exploit special capabilities of 
that terminal. 

TZ Time zone information. The format is xxxnzzz where xxx is standard local time zone 
abbreviation, n is the difference in hours from GMT, and zzz is the abbreviation for 
the daylight-saving local time zone, if any; for example, ESTSEDT. 

LOGNAME User's login id. 

Further names may be placed in the environment by the export command and “name=value” 

arguments in sh(1), or by exec(2). It is unwise to conflict with certain shell variables that are 

frequently exported by .profile files: MAIL, PS1, PS2, IFS. 
SEE ALSO 

env(1), login(1), sh(1), exec(2), getenv(3C), profile(5), term(7). 
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NAME 





fcntl - file control options 


SYNOPSIS 
#include <fenti.h> 


DESCRIPTION 
The fentl(2) function provides for control over open files. This include file describes requests 
and arguments to fent! and open(2). 


/* Flag values accessible to open(2) and fenti(2) */ 

/* (The first three can only be set by open) */ 

#defineO_RDONLY 0 

#defineO_WRONLY 1 

#defineO_RDWR 2 

#defineO_NDELAY 04 /* Non-blocking |/O */ 

#defineO_APPEND 010 /* append (writes guaranteed at the end) */ 


/* Flag values accessible only to open(2) */ 

#defineO_CREAT 00400 #/* open with file create (uses third open arg)*/ 
#defineO_TRUNC 01000 /* open with truncation */ 

#defineO_EXCL 02000 /* exclusive open */ 


/* fonti(2) requests */ 
#defineF_DUPFD 
#defineF _GETFD 
#defineF_SETFD 
#defineF_GETFL 
#defineF_SETFL 


SEE ALSO 
fentl(2), open(2). 


/* Duplicate fildes */ 
/* Get fildes flags */ 
/" Set fildes flags */ 
/* Get file flags */ 

/* Set file flags */ 


&QN — oO 
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GREEK(7) 


NAME 


greek - graphics for the extended TTY-37 type-box 


SYNOPSIS 


cat /usr/pub/greek [ | greek -Tterminal | 


DESCRIPTION | 
Greek gives the mapping from ASCil to the “shift-out” graphics in effect between SO and SI on 
TELETYPE® Model 37 terminals equipped with a 128-character type-box. These are the default 
greek characters produced by nroff(1). The filters of greek(1) attempt to print them on various 


other terminals. The file contains: 


alpha a A beta B B 
GAMMA r G delta 6 D 
epsilon e § zeta ¢ Q 
THETA eT theta 6 O 
LAMBDA A E mu ph M 
xi €& xX pi nr J 
rho p «K sigma o 6UY 
tau rT Od phi @ %U 
psi » V PSI VW H 
OMEGA Q Z nabla V 
partial a | integral of” 
FILES 
/usr/pub/greek 
SEE ALSO 
300(1), 4014(1), 450(1), greek(1), hp(1), tc(1), troff(1). 
Page 1 


gamma 
DELTA 
eta 
lambda 
nu 

PI 
SIGMA 
PHI 
omega 
not 


J&enyary ~s pr 


onyvver-zs— 
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NAME 


man - macros for formatting entries in this manual 


SYNOPSIS 


nroff -man files 
troff -man [ -rs1 | files 


DESCRIPTION 


Page 1 


These troff(1) macros are used to lay out the format of the entries of this manual. A skeleton 
entry may be found in the file /usr/man/man0O/skeleton. These macros are used by the man(1) 
command. 


The default page size is 8.5°°x11°°, with a 6.5°°x10°~ text area; the -rs1 option reduces 
these dimensions to 6°°x9°° and 4.75°°x8.375°~°, respectively; this option (which is not 
effective in nroff(1)) also reduces the default type size from 10-point to 9-point, and the vertical . 
line spacing from 12-point to 10-point. The -rV2 option may be used to set certain parameters 
to values appropriate for certain Versatec printers: it sets the line length to 82 characters, the 
page length to 84 lines, and it inhibits underlining; this option should not be confused with the 
-Tvp option of the man(1) command, which is available at some UNIX sites. 


Any text argument below may be one to six “words”. Double quotes ("") may be used to 
include blanks in a “word”. If text is empty, the special treatment is applied to the next line that 
contains text to be printed. For example, .1 may be used to italicize a whole line, or .SM followed 
by .B to make small bold text. By default, hyphenation is turned off for nroff, but remains on for 
troff. 


Type font and size are reset to default values before each paragraph and after processing font- 
and size-setting macros, e.g., .l, .RB, .SM. Tab stops are neither used nor set by any macro 
except .DT and .TH. 


Default units for indents in are ens. When in is omitted, the previous indent is used. This 
remembered indent is set to its default value (7.2 ens in troff, 5 ens in nroff-this corresponds to 
0.5~- in the default page size) by .TH, .PP, and .RS, and restored by .RE. 


THtscn Set the title and entry heading; t is the title, s is the section number, c is extra com- 
mentary, e.g., “local”, n is new manual name. Invokes .DT (see below). 

“SH text Place subhead text, e.g., SYNOPSIS, here. 

“SS text | Place sub-subhead fext, e.g., Options, here. 

.B text Make text bold. 

I text Make text italic. 

‘SM text Make text 1 point smaller than default point size. 

Riab Concatenate roman a with italic b, and alternate these two fonts for up to six argu- 
ments. Similar macros alternate between any two of roman, italic, and bold: 

JR .RB .BR JB BI 


P Begin a paragraph with normal font, point size, and indent. .PP is a synonym for .P. 
«HP in Begin paragraph with hanging indent. 
TP in Begin indented paragraph with hanging tag. The next line that contains text to be 


printed is taken as the tag. If the tag does not fit, it is printed on a separate line. 
AP tin Same as .TP in with tag t; often used to get an indented paragraph without a tag. 


RS in Increase relative indent (initially zero). Indent all output an extra in units from the 
current left margin. | 
.RE k Return to the kth relative indent level (initially, k==1; kK=0 is equivalent to k=1); if k 


is omitted, return to the most recent lower indent level. 

-PM m Produces proprietary markings; where m may be P for PRIVATE, N for NOTICE, BP 
for BELL LABORATORIES PROPRIETARY, or BR for BELL LABORATORIES RES- 
TRICTED. 
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.DT Restore default tab settings (every 7.2 ens in troff, 5 ens in nroff). 
PD v Set the interparagraph distance to v vertical spaces. If v is omitted, set the inter- 
paragraph distance to the default value (0.4v in troff, 1v in nroff). 


The following strings are defined: 





\+R ® in troff(1), (Reg.) in nroff(1). 
\«S Change to default type size. 
The following number registers are given default values by .TH: 
IN Left margin indent relative to subheads (default is 7.2 ens in troff, 5 ens in nroff). 
LL Line length including IN. | 
PD Current interparagraph distance. 
CAVEATS 


In addition to the macros, strings, and number registers mentioned above, there are defined a 
number of internal macros, strings, and number registers. Except for names predefined by 
troff(1) and number registers d, m, and y, all such internal names are of the form XA, where X 
is one of ), ], and }, and A stands for any alphanumeric character. 


lf a manual entry needs to be preprocessed by cw(1), eqn(1) (or neqn), and/or tb/(1), it must 
begin with a special line (described in man(1)), causing the man command to invoke the 
appropriate preprocessor(s). 


The programs that prepare the Table of Contents and the Permuted Index for this Manual 
assume the NAME section of each entry consists of a single line of input that has the following 
format: 


name[, name, name ...] \- explanatory text 


The macro package increases the inter-word spaces (to eliminate ambiguity) in the SYNOPSIS 
section of each entry. 





The macro package itself uses only the roman font (so that one can replace, for example, the 
bold font by the constant-width font-see cw(1)). Of course, if the input text of an entry contains 
requests for other fonts (e.g., .!, .RB, \fl), the corresponding fonts must be mounted. 


FILES : 
/usr/lib/tmac/tmac.an 
/ust/lib/macros/cmp.[nt].[dt].an 
/usr/lib/macros/ucmp.[nt].an 
/usr/man/man0/skeleton 


SEE ALSO 
man(1), troff(1). 


BUGS 
lf the argument to .TH contains any blanks and is not enclosed by double quotes (**), there will 
be bird-dropping-like things on the output. 
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NAME 





mm - the MM macro package for formatting documents 


SYNOPSIS 
mm [ options | [ files ] 
nroff -mm [ options |] [ files ] 
nroff -cm [ options | [ files ] 


mmt [ options } [ files ] 
troff -mm [ options ] [ files ] 
troff -cm [ options ] [ files ] 


DESCRIPTION 
This package provides a formatting capability for a very wide variety of documents. It is the 
standard package used by the BTL typing pools and documentation centers. The manner in 
which a document is typed in and edited is essentially independent of whether the document is 
to be eventually formatted at a terminal or is to be phototypeset. See the references below for 
further details. : 


The -mm option causes nroff(1) and troff(1) to use the non-compacted version of the macro 
package, while the -cm option results in the use of the compacted version, thus speeding up the 
process of loading the macro package. 





FILES 
/usr/lib/tmac/tmac.m pointer to the non-compacted version of the package 
/usr/lib/macros/mm{[nt] non-compacted version of the package 
/usr/lib/macros/cmp.[nt].[dt].m compacted version of the package 
/usr/lib/macros/ucmp.[nt].m initializers for the compacted version of the package 
SEE ALSO : = 


mm(1), mmt(1), troff(1). 
MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 
Typing Documents with MM by D. W. Smith and E. M. Piskorik. 
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NAME 
ms - macros for formatting manuscripts 


SYNOPSIS 
nroff -ms [ options ] file ... 
troff -ms [ options ] file ... 


DESCRIPTION 
This package of nroff and troff macro definitions provides a canned formatting facility for techni- 
cal papers in various formats. When producing 2-column output on a terminal, filter the output 
through col(1). 





The macro requests are defined below. Many nroff and troff requests are unsafe in conjunction 
with this package, however these requests may be used with impunity after the first .PP: 





.bp begin new page 
-br break output line here 
spn insert n spacing lines 
isn (line spacing) n=1 single, n=2 double space 
na no alignment of right margin 
Output of the eqn, neqn, refer, and tbi(1) preprocessors for equations and tables is acceptable 
as input. 
FILES 
/usr/lib/tmac/tmac.s 
SEE ALSO 
eqn(1), troff(1), refer(1), tbi(1) 
REQUESTS 
Initial Cause 
Request Value Break Explanation . 
1C yes yes One column format on a new page. 
.2C no yes Two column format. 
.AB no yes Begin abstract. 
.AE - yes End abstract. 
Al no yes Author's institution follows. Suppressed in TM. 
.AT no yes Print ‘Attached’ and turn off line filling. 
AU xy no yes Author's name follows. x is location and y is 


extension, ignored except in TM. 


.B x no no Print x in boldface; if no argument switch to 
boldface. 

.B1 no yes Begin text to be enclosed in a box. 

.B2 no yes End text to be boxed and print it. 

.BT | date no Bottom title, automatically invoked at foot of 





page. May be redefined. 
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-BX x no no Print x in a box. 





CS x... -  .s—~«yes Cover sheet info if TM format, suppressed 
7 otherwise. Arguments are number of text 
pages, other pages, total pages, figures, 

tables, references. 


.CT no yes Print ‘Copies to’ and enter no-fill mode. 

.DA x nroff no ‘Date line’ at bottom of page is x. Default is 
today. 

.DE - yes End displayed text. Implies .KE. 

.DS x no _—syes Start of displayed text, to appear verbatim 


line-by-line. x=I for indented display 
(default), x=L for left-justified on the page, 
x=C for centered, x=B for make left-justified 
block, then center whole block. Implies .KS. 


.EG no - Print document in BTL format for ‘Engineer's 
Notes.’ Must be first. 


.EN - yes Space after equation produced by eqn or 


neqn. 


EQ xy - yes Precede equation; break out and add space. 
| Equation number is y. The optional argument 

x may be / to indent equation (default), L to 

left-adjust the equation, or C to center the 





equation. 
.FE - yes End footnote. 
.FS no no Start footnote. The note will be moved to the 
| | bottom of the page. 
HO - no ‘Bell Laboratories, Holmdel, New Jersey 
: 07733’. 
Ax no no Italicize x; if x missing, italic text follows. 
JH ~~ no no ‘Bell Laboratories, Naperville, Illinois 60540' 
IM no no Print document in BTL format for an internal 


memorandum. Must be first. 


IP xy no yes Start indented paragraph, with hanging tag x. 
Indentation is y ens (default 5). 


KE - yes End keep. Put kept text on next page if not 
enough room. 
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.KF no yes Start floating keep. If the kept text must be 
moved to the next page, float later text back 
to this page. 

.KS no yes Start keeping following text. 

.LG no no Make letters larger. 

.LP yes yes Start left-blocked paragraph. 

MF - - Print document in BTL format for ‘Memoran- 


dum for File.’ Must be first. 


.MH - no ‘Bell Laboratories, Murray Hill, New Jersey 
07974’. 
.MR - - Print document in BTL format for ‘Memoran- 


dum for Record.’ Must be first. 


‘ND date __ troff no Use date supplied (if any) only in special BTL 
format positions; omit from page footer. 


NH n - yes Same as .SH, with section number supplied 
automatically. Numbers are multilevel, like 
1.2.3, where n tells what level is wanted 
(default is 1). 





«NL yes no Make letters normal size. 

OK - yes ‘Other keywords’ for TM cover sheet follow. 

PT pg# - Page title, automatically invoked at top of 
page. May be redefined. 

.PY - no ‘Bell Laboratories, Piscataway, New Jersey 
08854’ 

-QE - yes End quoted (indented and shorter) material. 

.QP - yes Begin single paragraph which is indented and 
shorter. 

.QS - yes Begin quoted (indented and shorter) material. 

.R yes no Roman text follows. 

.RE - yes End relative indent level. 

.RP no - Cover sheet and first page for released paper. 
Must precede other requests. 
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.RS - yes Start level of relative indentation. Following 
7 IP's are measured from current indentation. 





.SG Xx no yes Insert signature(s) of author(s), ignored 

- except in TM. x is the reference line (initials 
| of author and typist). 

.SH - yes Section head follows, font automatically bold 

.SM no no Make letters smaller. 

.TA X ... 5 ... no Set tabs in ens. Default is 5 10 15... 

TE - yes End table. 

TH - yes End heading section of table. 

TL no yes Title follows. 

.TM x... no - Print document in BTL technical memoran- 


dum format. Arguments are TM number, 
(quoted list of) case number(s), and file 
number. Must precede other requests. 


TR xX - - Print in BTL technical report format; report 
number is x. Must be first. 





TS x - yes Begin table; if x is H table has repeated head- 
ing. | 

(UL x - no Underline argument (even in troff). 

{UX - no ‘UNIX’; first time used, add footnote ‘UNIX is 
a trademark of Bell Laboratories.’ 

.WH - no ‘Bell Laboratories, Whippany, New Jersey 
07981’. 
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NAME 





mv - a macro package for making view graphs 


SYNOPSIS 
mvt [ options ] [ files ] 
troff -mv [ options ] [ files ] 


DESCRIPTION 
This package provides an easy-to-use facility for making view graphs and projection slides in a 
variety of formats. A dozen or so macros are provided that accomplish most of the formatting 
tasks needed in making transparencies. All of the facilities of troff(1), eqn(1), and tb/(1) are 
available for more difficult tasks. The output can be previewed on most terminals, and, in partic- 
ular, on the Tektronix 4014 and on the Versatec printer. See the reference below for further 
details. 


FILES 
/usr/lib/tmac/tmac.v 


SEE ALSO 
eqn(1), mvt(1), tbl(1), troff(1). 
A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W. Smith (in prepara- 
tion). 
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NAME 





regexp - regular expression compile and match routines 


SYNOPSIS 
#define INIT <declarations > 
#define GETC() <getc code> 
#define PEEKC() <peekc code> 
#define UNGETC(c) <ungetc code> 
#define RETURN(pointer) <return code> 
#define ERROR(val) <error code> 


#include <regexp.h> 


char +«compile(instring, expbuf, endbuf, eof) 
char zinstring, «expbuf, «endbuf; 


int step(string, expbuf) 
char «String, «expbuf; 


DESCRIPTION | 
This page describes general purpose regular expression matching routines in the form of ed(1), 
defined in /usr/include/regexp.h. Programs such as ed(1), sed(1), grep(1), bs(1), expr(1), 
etc., which perform regular expression matching use this source file. In this way, only this file 
need be changed to maintain regular expression compatibility. 


The interface to this file is unpleasantly complex. Programs that include this file must have the 
following five macros declared before the “#include <regexp.h>” statement. These macros 
are used by the compile routine. 


GETC() Return the value of the next character in the regular expression pattern. 
Successive calls to GETC() should return successive characters of the 
regular expression. 





PEEKC() ~~: Return the next character in the regular expression. Successive calls to 
PEEKC() should return the same character (which should also be the next 
character returned by GETC()). 


UNGETC(c) Cause the argument c to be returned by the next call to GETC() (and 
PEEKC()). No more that one character of pushback is ever needed and 
this character is guaranteed to be the last character read by GETC(). The 
value of the macro UNGETC(c) is always ignored. 


RETURN(pointer) This macro is used on normal exit of the compile routine. The value of 
the argument pointer is a pointer to the character after the last character 
of the compiled regular expression. This is useful to programs which 
have memory allocation to manage. 


ERROR(va!) This is the abnormal return from the compile routine. The argument val 
is an error number (see table below for meanings). This call should never 
return. 
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ERROR MEANING 

11 Range endpoint too large. 

16 Bad number. 

25 “\digit” out of range. 

36 Illegal or missing delimiter. 

41 No remembered search string. 

42 \( \) imbalance. 

43 Too many \(. 

44 More than 2 numbers given in \{ \}. 
45 } expected after \. 

46 First number exceeds second in \{ \}. 
49 [ ] imbalance. 

50 Regular expression overflow. 


The syntax of the compile routine is as follows: 
compile(instring, expbuf, endbuf, eof) 


The first parameter instring is never used explicitly by the compile routine but is useful for pro- 
grams that pass down different pointers to input characters. It is sometimes used in the INIT 
declaration (see below). Programs which call functions to input characters or have characters in 
an external array can pass down a value of ((char «) 0) for this parameter. 


The next parameter expbuf is a character pointer. It points to the place where the compiled 
regular expression will be placed. 


The parameter endbuf is one more that the highest address that the compiled regular expres- 
sion may be placed. If the compiled expression cannot fit in (endbuf-expbuf) bytes, a call to 
ERROR(50) is made. 


The parameter eof is the character which marks the end of the regular expression. For exam- 
ple, in ed(1), this character is usually a /. 


Each programs that includes this file must have a #define statement for INIT. This definition 
will be placed right after the declaration for the function compile and the opening curly brace ( {). 
It is used for dependent declarations and initializations. Most often it is used to set a register 
variable to point the beginning of the regular expression so that this register variable can be 
used in the declarations for GETC(), PEEKC() and UNGETC(). Otherwise it can be used to 
declare external variables that might be used by GETC(), PEEKC() and UNGETC(). See the 
example below of the declarations taken from grep(1). 





There are other functions in this file which perform actual regular expression matching, one of 
which is the function step. The call to step is as follows: 


step(string, expbuf) 


The first parameter to step is a pointer to a string of characters to be checked for a match. This 
string should be null terminated. 


The second parameter expbuf is the compiled regular expression which was obtained by a call 
of the function compile. 


The function step returns one, if the given string matches the regular expression, and zero if the 
expressions do not match. If there is a match, two external character pointers are set as a side 
effect to the call to step. The variable set in step is loc1. This is a pointer to the first character 
that matched the regular expression. The variable foc2, which is set by the function advance, 
points the character after the last character that matches the regular expression. Thus if the 
regular expression matches the entire line, loc1 will point to the first character of string and loc2 
will point to the null at the end of string. 
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Step uses the external variable circf which is set by compile if the regular expression begins 
with *. If this is set then step will only try to match the regular expression to the beginning of 
the string. If more than one regular expression is to be compiled before the the first is executed 
the value of circf should be saved for each compiled expression and circf should be set to that 
saved value before each call to step. 


The function advance is called from step with the same arguments as step. The purpose of 


step is to step through the string argument and call advance until advance returns a one indi- 


cating a match or until the end of string is reached. If one wants to constrain string to the 
beginning of the line in all cases, step need not be called, simply call advance. 


When advance encounters a * or \{ \} sequence in the regular expression it will advance its 
pointer to the string to be matched as far as possible and will recursively call itself trying to 
match the rest of the string to the rest of the regular expression. As long as there is no match, 
advance will back up along the string until it finds a match or reaches the point in the string that 
initially matched the « or \{ \}. It is sometimes desirable to stop this backing up before the ini- 
tial point in the string is reached. If the external character pointer locs is equal to the point in 
the string at sometime during the backing up process, advance will break out of the loop that 
backs up and will return zero. This is used be ed(1) and sed(1) for substitutions done globally 
(not just the first occurrence, but the whole line) so, for example, expressions like s/ys//g do not 
loop forever. 


The routines ecmp and getrange are trivial and are called by the routines previously mentioned. 


EXAMPLES 


FILES 


The following is an example of how the regular expression macros and calls look from grep(1): 
#define INIT register char «sp = instring; 

#define GETC() (xsp-+-+) 

#define PEEKC() (*Sp) 

#define UNGETC(c) (--sp) 

#define RETURN(c) return; 

#define ERROR(c) regerr( ) 


#include <regexp.h> 
compile(«argv, expbuf, &expbuf[ESIZE], ~\0°); 


if(step(linebuf, expbuf)) 
succeed( ); 


/usr/include/regexp.h 


SEE ALSO 


BUGS 
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ed(1), grep(1), sed(1). 


The handling of circf is kludgy. | 

The routine ecmp is equivalent to the Standard I/O routine strncmp and should be replaced by 
that routine. 

The actual code is probably easier to understand than this manual page. 
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NAME 


stat - data returned by stat system call 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/stat.h> 


DESCRIPTION . 
The system calls stat and fstat(2) return data whose structure is defined by this include file. 
The encoding of the field st_mode is defined in this file also. 


f° 
* Structure of the result of stat 
i 


struct _ stat 
; dev_t st_dev; 
ino_t St_ino; 
ushort st_mode; 
short st_nlink; 
ushort st_uid; 
ushort st_gid; 
dev_t st_rdev; 
off_t st_size; ° 
time_t st_atime; 
time_t st_mtime; 
time_t st_ctime; 
}; 
#define S_IFMT 0170000 
#define S_IFDIR 0040000 
#define S_IFCHR 0020000 
#define S_IFBLK 0060000 
#define S_IFREG 0100000 
#define S_IFIFO 0010000 
#define S_ISUID 04000 
#define S_ISGID 02000 
#define S_ISVTX 01000 
#define S_IREAD 00400 
#define S_IWRITE 00200 
#define S_IEXEC 00100 
FILES 
/ust/include/sys/types.h 
/usr/include/sys/stat.h 
SEE ALSO 
stat(2). 
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/* type of file */ 

/* directory */ 

/* character special */ 

/* block special */ 

/* regular */ 

/* fifo */ 

/* set user id on execution */ 

/* set group id on execution */ 

/" save swapped text even after use */ 
/* read permission, owner */ 

/* write permission, owner */ 

/* execute/search permission, owner */ 
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NAME 
term - conventional names 


DESCRIPTION 
These names are used by certain commands (e.g., nroff(1), mm(1), man(1), fabs(1)) and are 


maintained as part of the shell environment (see sh(1), profile(5), and environ(7)) in the variable 
STERM: 


1520 Datamedia 1520 

1620 Diablo 1620 and others using the HyType II printer 

1620-12 same, in 12-pitch mode 

2621 Hewlett-Packard HP2621 series 

2631 Hewlett-Packard 2631 line printer 

2631-c Hewlett-Packard 2631 line printer - compressed mode 

2631-e Hewlett-Packard 2631 line printer - expanded mode 

2640 - Hewlett-Packard HP2640 series 

2645 Hewlett-Packard HP264n series (other than the 2640 series) 

300 DASI/DTC/GS! 300 and others using the HyType | printer 

300-12 same, in 12-pitch mode 

300s DASI/DTC/GSI 300s 

382 DTC 382 

300s-12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE® Model 33 KSR 

37 TELETYPE Model 37 KSR 

40-2 TELETYPE Model 40/2 

4000A  Trendata 4000A 

4014 Tektronix 4014 

43 TELETYPE Model 43 KSR 

450 DASI 450 (same as Diablo 1620) 

450-12 same, in 12-pitch mode 

735 Texas Instruments T1735 and TI725 

745 Texas Instruments T1745 

dumb generic name for terminals that lack reverse 
line-feed and other special escape sequences 

hp Hewlett-Packard (same. as 2645) 

Ip generic name for a line printer 

tn1200 General Electric TermiNet 1200 

tn300 General Electric TermiNet 300 

vti00 Digital VT100 


Up to 8 characters, chosen from [-a-z0-9], make up a basic terminal name. Terminal sub- 
models and operational modes are distinguished by suffixes beginning with a -. Names should 
generally be based on original vendors, rather than local distributors. A terminal acquired from 
one vendor should not have more than one distinct basic name. 








Commands whose behavior depends on the type of terminal should accept arguments of the 
form -Tterm where term is one of the names given above; if no such argument is present, such 
commands should obtain the terminal type from the environment variable $STERM, which, in turn, 
should contain term. 


SEE ALSO 
mm(1), nroff(1), tplot(1G), sh(1), stty(1), tabs(1), profile(5), environ(7). 


BUGS 
This is a small candle trying to illuminate a large, dark problem. Programs that ought to adhere 
to this nomenclature do so somewhat fitfully. , 





Page 1 March 30, 1984 


TYPES(7) TYPES(7) 


NAME 

types - primitive system data types 
SYNOPSIS 

#incilude <sys/types.h> 


DESCRIPTION 
The data types defined in the include file are used in UNIX system code; some data of these 
types are accessible to user code: 


typedef struct { int r[1]; } * physadr; 








typedef long daddr_t; 
typedef char * caddr_t; 
typedef unsigned short ushort; 
typedef ushort ino_t; 
#ifdef m68 

typedef short cnt_t; 
#else 

typedef char cnt_t; 
#endif 

typedef long time_t; 
#ifndef OVKRNL 

#ifdef M68 

typedef int label_t[13]; /* a2-a7, d2-d7, & pc */ 
#else 

typedef int label_t(9]; /* program status regs r7 - r15 */ 
#endif 

#else 

typedef int label_t[10]; 
#endif 

typedef short dev _t; 
typedef long off_t; 
typedef long paddr _t; 


The form daddr_t is used for disk addresses except in an i-node on disk, see fs(5). Times are 
encoded in seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a dev- 
ice code specify kind and unit number of a device and are installation-dependent. Offsets are 
measured in bytes from the beginning of a file. The /abe/_t variables are used to save the pro- 
cessor state while another process is running. 


SEE ALSO 
fs(5). 
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NAME 





intro - introduction to system maintenance procedures 


DESCRIPTION 
This section outlines certain procedures that will be of interest to those charged with the task of 
system maintenance. Included are discussions on such topics as recovery from crashes, file 
backups, etc. 

NOTES 
Plexus added the commands autoboot, dcontig, dformat, fbackup, and gettytab. The com- 
mands 7Oboot, diskboot, etp, hasp, romboot, rp6fmt, tapeboot, unixboot, uvac, and vaxops 
have been eliminated. In most cases, the deleted commands apply to non-Plexus hardware. 
Because of its frequent use in system maintenance, the shutdown command has been moved 
to this section from Section 1. 

BUGS 
No manual can take the place of good, solid experience. 
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NAME 
autoboot - automatic reboot 


DESCRIPTION : 
Plexus UNIX can be configured to boot itself from a system reset or power failure and go into 
multi-user or single-user state. If autoboot is enabled, the software: 


1) boots the default system as set by the standalone programs dconfig or dformat, and 


2) goes into state 8, the autoboot state. In state 8, the file /etc/rc does an /etc/fsck on the 
default disk devices and then goes into state 2, multi-user. 


To enable autoboot, set switch S4 of the processor board switchpak to the ON position. See the 
section titled "Processor Board Options" in the appendix titled "Board-Level Configuration 
Options" in the Plexus User’s Manual. 


NOTES 
This is a Plexus command. It is not part of standard SYSTEM Ill. 


SEE ALSO 
init(8), rc(8). 


BUGS 
While autoboot can ensure a running system when no one is around to reboot after a crash, it 


does not resolve the cause of the crash or fix any damage done by it. 
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NAME 


crash - what to do when the system crashes 


DESCRIPTION 


Page 1 


This entry gives at least a few clues about how to proceed if the system crashes. It can't pre- 
tend to be complete. 


How to bring it back up. \f the reason for the crash is not evident (see below for guidance on 
“evident”) you may want to try to dump the system if you feel up to debugging. At the moment 
a dump can be taken only an magtape. With a tape mounted and ready, stop the machine, load 
address 44(8) (on the PDP-11), 400(16) (on the VAX-11/780; see vaxops(8)), and start. This 
should write a copy of all of core on the tape with an EOF mark. Be sure the ring is in, the tape 
is ready, and the tape is clean and new. 


in restarting after a crash, always bring up the system single-user, as specified in unixboot(8) 
as modified for your particular installation. Then perform an fsck(1M) on all file systems which 
could have been in use at the time of the crash. If any serious file system problems are found, 
they should be repaired. When you are satisfied with the health of your disks, check and set the 
date if necessary, then come up multi-user. 


To even boot UNIX at all, three files (and the directories leading to them) must be intact. First, 
the initialization program /etc/init must be present and executable. If it is not, the CPU will loop 
in user mode at location 6(8) (PDP-11), 13(16) (VAX-11/780). For init to work correctly, 
/dev/console and /bin/sh must be present. If either does not exist, the symptom is best 
described as thrashing. Init will go into a fork/exec loop trying to create a Shell with proper 
standard input and output. 


lf you cannot get the system to boot, a runnable system must be obtained from a backup 
medium. The root file system may then be doctored as a mounted file system as described 
below. If there are any problems with the root file system, it is probably prudent to go to a 
backup system to avoid working on a mounted file system. 


Repairing disks. The first rule to keep in mind is that an addled disk should be treated gently; it 
shouldn't be mounted unless necessary, and if it is very valuable yet in quite bad shape, 
perhaps it should be copied before trying surgery on it. This is an area where experience and 
informed courage count for much. 


Fsck(iM) is adept at diagnosing and repairing file system problems. It first identifies all of the 
files that contain bad (out of range) blocks or blocks that appear in more than one file. Any such 
files are then identified by name and fsck requests permission to remove them from the file sys- 
tem. Files with bad blocks should be removed. In the case of duplicate blocks, all of the files 
except the most recently modified should be removed. The contents of the survivor should be 


checked after the file system is repaired to ensure that it contains the proper data. (Note that 


running fsck with the -n option will cause it to report all problems without attempting any repair.) 


Fsck will also report on incorrect link counts and will request permission to adjust any that are 
erroneous. In addition, it will reconnect any files or directories that are allocated but have no file 
system references to a “lost-+-found” directory. Finally, if the free list is bad (out of range, miss- 
ing, or duplicate blocks) fsck will, with the operators concurrence, construct a new one. 


Why did it crash? UNIX types a message on the console typewriter when it voluntarily crashes. 
Here is the current list of such messages, with enough information to provide a hope at least of 
the remedy. The message has the form “panic: ...”, possibly accompanied by other informa- 
tion. Left unstated in all cases is the possibility that hardware or software error produced the 
message in some unexpected way. 


bikdev 


The getbik routine was called with a nonexistent major device as argument. Definitely 
hardware or software error. 
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devtab 


Null device table entry for the major device used as argument to getbik. Definitely 
hardware or software error. 





iinit An l/O error reading the super-block for the root file system during initialization. 


no fs 
A device has disappeared from the mounted-device table. Definitely hardware or software 
error. 

no imt 
Like “no fs”, but produced elsewhere. 

no clock 


During initialization, neither the line nor programmable clock was found to exist. 


/O error in swap 
An unrecoverable |/O error during a swap. Really shouldn't be a panic, but it is hard to fix. 


out of swap space 
A program needs to be swapped out, and there is no more swap space. It has to be 
increased. This really shouldn't be a panic, but there is no easy fix. 


trap An unexpected trap has occurred within the system. This is accompanied by three 
numbers: a “ka6”, which is the contents of the segmentation register for the area in which 
the system's stack is kept; “aps”, which is the location where the hardware stored the pro- 
gram status word during the trap; and a “trap type” which encodes which trap occurred. 
The trap types are: | 


PDP-11: 

bus error 

illegal instruction 

BPT/trace 

lOT 

power fail 

EMT 

recursive system call (TRAP instruction) 
11/70 cache parity, or programmed interrupt 
floating point trap 

segmentation violation 


VAX-11/780: 
reserved addressing fault 
illegal instruction 
BPT instruction trap 
XFC instruction trap 
reserved operand fault 
recursive system call (CHMK instruction) 
floating point trap 
software level 1 (reschedule) trap 
segmentation violation 
protection fault is 
10 trace trap 
11 compatibility mode fault 
In some of these cases it is possible for octal 40 to be added into the trap type; this indicates 
that the processor was in user mode when the trap occurred. If you wish to examine the stack 
after such a trap, either dump the system, or use the console switches to examine core; the 
required address mapping is described below. 





COON DORON “~~ © 


COON OOPAN —“ © 
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Interpreting dumps. All file system problems should be taken care of before attempting to look 
at dumps. The dump should be read into the file /usr/tmp/core; cp(1) will do. At this point, you 
should execute ps -el -c /usr/tmp/core and who to print the process table and the users who 
were on at the time of the crash. 

Additional information for the PDP-11. You should dump (adb(1)) the first 30 bytes of 
/usr/tmp/core. Starting at location 4, the registers RO, R1, R2, R3, R4, R5, SP and KDSA6 (KISA6 
for 11/40s) are stored. If the dump had to be restarted, RO will not be correct. Next, take the 
value of KA6 (location 22(8) in the dump) multiplied by 100(8) and dump 2000(8) bytes starting 
from there. This is the per-process data associated with the process running at the time of the 
crash. Relabel the addresses 140000 to 141776. R5 is C’s frame or display pointer. Stored at 
(RS) is the old R5 pointing to the previous stack frame. At (R5)+-2 is the saved PC of the calling 
procedure. Trace this calling chain until you obtain an R5 value of 141756, which is where the 
user's R5 is stored. If the chain is broken, you have to look for a plausible R5, PC pair and con- 
tinue from there. Each PC should be looked up in the system's name list using adb(1) and its : 
command, to get a reverse calling order. In most cases this procedure will give an idea of what 
is wrong. A more complete discussion of system debugging is impossible. 


SEE ALSO 
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adb(1), fsck(1M), unixboot(8), vaxops(8). 
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NAME 
dconfig - configure logical disks . 

SYNOPSIS 
/etc/dcontig - for use under UNIX 
dconfig - for running program from release tape only 
/stand/dconfig - for standalone use (UNIX not running) only 

DESCRIPTION 
Dconfig allows you to change the Sys3 default logical disk address assignments and the default 
UNIX device mapping. It also can be used to verify the logical disk configuration, change the 
system nodename for uucp and uname, or change the primary bootname. 
Deonfig has both regular (/etc/dconfig) and standalone (/stand/dconfig) versions. Plexus 
release tapes also contain a copy of dconfig. The arguments to /etc/dconfig (the regular ver- 
sion) differ from those for the standalone and tape versions. /ete/dconfig expects the special 
files defined in the /dev directory as arguments, while the standalone version and the release 
tape version both use built-in special filenames as described in the Plexus User's Manual. 
Dconfig prompts for responses, and gives the current values for each parameter in brackets. A 
<return> leaves the values the same; a <return> in response to a yes or no question 
defaults to "no". Unlike most Sys3 programs, dconfig expects response in terms of 512-byte 
sectors, rather than 1024 byte blocks. 
Dconfig asks "Disk?". If dconfig for any reason (e.g., permissions) cannot access the disk you 
‘type, it continues to give the "Disk?" prompt. For complete information and examples, see the 
Plexus User’s Manual. 

NOTES | 
This is a Plexus command. It is not part of stock SYSTEM Ill. 

SEE ALSO 
uname(1). 

BUGS 


Page 1 


/etc/dconfig should be used only to examine and not change data. 
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NAME 
dformat - disk formatter 


SYNOPSIS 
dformat - for running the program from a release tape only 


/stand/dformat - for standalone use (no UNIX) only 


DESCRIPTION 
Dformat is the Sys3 disk formatting program. One option to dformat formats the disk and 
spares bad sectors; another just spares bad sectors. Other options differ for the P/40 and P/25; 
all are explained in detail in the Plexus User’s Manual. 


Dformat prompts for the parameters it needs. For examples, see the Plexus User's Manual. 


NOTES 
This is a Plexus command. It is not part of standard SYSTEM Il. 


SEE ALSO 
Plexus User’s Manual 
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NAME 





fbackup - make a fast tape backup of a file system 


SYNOPSIS 
fbackup - for running the program from a release tape only 


/stand/fbackup - for standalone (no UNIX) use only 


DESCRIPTION 
The standalone program fbackup makes a fast copy of data on disk to tape, or data on tape to 
disk. It is usually used to make a copy of a file system. Fbackup is faster than dump and 
writes in a format that is understood by dd (i.e., it is a byte-by-byte copy), so you should use 
fbackup rather than dump if you need the speed. See NOTES below for when to use which of 
the syntax descriptions above. 


Fbackup prompts for its arguments. It can copy between an iSBC disk and 9-track tape or 
between an IMSC disk and cartridge. It does not support copies between an IMSC disk and 9- 
track tape or an iSBC disk and a cartridge. Fbackup writes to 9-track tape in block sizes of 
16K bytes per record. 


To use fbackup, you need to know the starting disk address of the file system, and its length in 
512-byte disk sectors. To find this out, use dconfig(8). 


On P/40 systems with the cartridge tape option, fbackup writes to the cartridge tape, not the 9- 
track tape. | | 


NOTES | 
This is a Plexus program. It is not part of standard SYSTEM Ill. 


SEE ALSO 
Plexus User's Manual 


BUGS | a 
Foackup accepts unsupported combinations of disk and tape and proceeds to copy between a 
supported combination. 
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NAME 





filesave, tapesave - daily/weekly UNIX file system backup 
SYNOPSIS 


letc/filesave.? 
/etc/tapesave 


DESCRIPTION 
These shell scripts are provided as models. They are designed to provide a simple, interactive 
operator environment for file backup. Filesave.? is for daily disk-to-disk backup and tapesave 
is for weekly disk-to-tape. 
The suffix .? can be used to name another system where two (or more) machines share disk 
drives (or tape drives) and one or the other of the systems is used to perform backup on both. 


SEE ALSO 
shutdown(8), volcopy(1M). 
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NAME 
getty - set the modes of a terminal 


SYNOPSIS 7 
/etc/getty name type delay 


DESCRIPTION 
Getty is normally invoked by init(8) as the first step in allowing users to login to the system. 
Lines in /etc/inittab tell init to invoke getty with the proper arguments. 


Name should be the name of a terminal in /dev (e.g., tty03); type should be a single character 
chosen from -, 0, 1, 2, 3, 4, 5, or 6 (may vary locally) which selects a speed table in getty, or }, 
which tells getty to update /etc/utmp and exit; delay is relevant for dial-up ports only. It speci- 
fies the time in seconds that should elapse before the port is disconnected if the user does not 
respond to the login: request. 


First, getty types the login: message. The login: message depends on the speed table being 
used, and may include the characters that put the GE TermiNet 300 terminal into full-duplex, 
take the DAS! terminals out of the plot mode, or put a TELETYPE® Model 37 into full-duplex. 
Then the user's login name is read, a character at a time. 


While reading, getty tries to adapt to the terminal, speed, and mode that is being used. If a null 
character is received, it is assumed to be the result of a “break” (“interrupt”). The speed is then 
changed based on the speed table that getty is using, and login: is typed again. Subsequent 
breaks cause a cycling through the speeds in the speed table being used. | 


The user's login name is terminated by a new-line or carriage-return character. The latter 
results in the system being set to treat carriage returns appropriately. If the login name contains 
only upper-case alphabetic characters, the system is told to map any future upper-case charac- 
ters into the corresponding lower-case characters. 


Finally, login(1) is called with the user’s login name as argument. 
Speed sequences for the speed tables: 


B110; for 110 baud console TTY. 

B300-B150-B110-B1200; normal dial-up sequence starting at B300. 
B150; no sequence. 

B2400; no sequence. 

B1200-B300-B150-B110; normal dial-up sequence starting at 81200. 
B300; for console DECwriter. 

B9600; no sequence. 

B4800-B9600; for Tektronix 4014. 

B4800; no sequence. 

External a, 19.2K baud, no sequence. 

External b, baud rate determined by external switches, no sequence. 


Additional speed tables can be defined via gettytab.c. See gettytab(8). 


SEE ALSO 
login(1), tty(4), inittab(5), utmp(5), init(8), gettytab(8). 
BUGS 
Ideally, the speed tables would be read from a file, not compiled into getty. 


conan rhQWn—o' 
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NAME 
gettytab - defining speed tables for getty 


SYNOPSIS 
/usr/src/cmd/gettytab.c 
/usr/src/cmd/getty.object 
/usr/src/cmd/getty.mk 


DESCRIPTION 
When getty(8) is called, it looks at /ete/inittab. Each line in /etc/inittab specifies one of several 
"speed tables" within getty. Based on the speed table argument given in /etc/inittab, getty 
sets the "initial" mode of a serial port, prints the "login: " message, reads the response, and 
sets the "final" mode of the serial port. Getty then terminates by executing the /ogin(1) pro- 
gram. 





Gettytab.c allows you to define additional speed tables, over and above those already defined 
in getty. 

To define new speed tables, add speed-table entries to the file /usr/src/cmd/gettytab.c, and 
recompile and install the file along with getty.object as prescribed within the getty.mk file. 
Choose a speed table name other than those already known to getty. See getty(8) for this list. 
Note that “a” and “b” are already known. Attempts to redefine a known speed table will fail. 


To test the changed getty before installing it as /etc/getty, copy the new getty to a user direc- 
tory and make an entry in /etc/inittab that refers to the new getty. For example, in /etc/inittab 
change the line 

2:11:c:/etc/getty tty11 b 


to 





2:11:c:/usr/you/getty tty11 c 


for serial port 11 and speed table “c”. Only one entry in /etc/inittab may refer to serial port 11. 
To activate the new getty type 


init 2 


When the user on serial port 11 logs off, the new getty will be executed. 
NOTES 

This is a Plexus command. It is not part of standard SYSTEM Ill. 
SEE ALSO 

getty(8), init(8), inittab(5), tty(4). 
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NAME 


INIT(8) 


init - process control initialization 


SYNOPSIS 


/etc/init [ state ] 


DESCRIPTION 


Init is invoked inside UNIX as the last step in the boot procedure. It is process number one, and 
is the ancestor of every other process in the system. As such, it can be used to control the pro- 
cess structure of the system. If init is invoked with an argument by the super-user, it will cause 
a change in state of process one. 


Init has 9 states, 1 through Q; it is invoked by the system in state 1, and it performs the same 
functions on entering each state. When a state is entered, init reads the file /etc/inittab. Lines 
in this file have the format: 


state:id:flags:command 


All lines in which the state field matches init's current state are recognized. If a process is 
active under the same two character id as a recognized line, it may be terminated (signal 15), 
killed (signal 9), or both by including the flags t and k in the order desired. The signal is sent to 
all processes in the process group associated with the id. The command field is saved for later 
execution. 


On first invocation by Sys3, init sees if autoboot is enabled. If it is, init puts the system in state 
8, the autoboot state. 


After reading /etc/inittab and signaling running processes as required, but before invoking any 
processes under the new state, /etc/re is invoked with three arguments. This command file per- 
forms housekeeping such as removing temporary files, mounting file systems, and starting dae- 
mons. The three arguments are the current state, the number of times this state has been 
entered previously, and the prior state. /nit will also execute /etc/re at the request of the operat- 
ing system (e.g., when recovering from power failure). In this last case, the first argument has 
an x appended to it. 


When /etc/rc has finished executing, init invokes all commands waiting to be executed. (A 
command is waiting to be executed if there is no process currently running that has the same id 
as the command.) The flag ¢ (continuous) requires the command to be continuously reinvoked 
whenever the process with that id dies. The flag o (off) causes the command to be ignored. 
This is useful for turning lines off without extensive editing. Otherwise, the command is invoked 
a maximum of one time in the current state. 


Init invokes the command field read from /etc/inittab by opening / for reading and writing on file 
descriptors 0, 1, and 2, resetting all signals to system default, setting up a.new process group 
(setpgrp(2)), and execing: 


/bin/sh -c exec command 


DIAGNOSTICS 


BUGS 


FILES 
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When init can do nothing else because of a missing /etc/inittab or when it has no children left, it 
will try to execute a shell on /dev/console. When the problem has been fixed, it is necessary to 
change states, and terminate the shell. 


Init does not complain if the state-id pairs in /etc/inittab are not unique. For any given pair, the 
last one in the file is valid. 


/etc/inittab 
/etc/rc 
/bin/sh 
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/dev/console 


SEE ALSO 
login(1), sh(1), exec(2), setpgrp(2), inittab(5), getty(8). 











April 2, 1984 Page 2 


MAKEKEY(8) MAKEKEY(8). . 


NAME 





makekey - generate encryption key 


SYNOPSIS 
/usr/lib/makekey 


DESCRIPTION 
Makekey improves the usefulness of encryption schemes depending on a key by increasing the 
amount of time required to search the key space. It reads 10 bytes from its standard input, and 
writes 13 bytes on its standard output. The output depends on the input in a way intended to be 
difficult to compute (i.e., to require a substantial fraction of a second). 


The first eight input bytes (the input key) can be arbitrary ASCII characters. The last two (the 
salt) are best chosen from the set of digits, ., /, and upper- and lower-case letters. The salt 
characters are repeated as the first two characters of the output. The remaining 11 output char- 
acters are chosen from the same set as the salt and constitute the output key. 


The transformation performed is essentially the following: the salt is used to select one of 4,096 
cryptographic machines all based on the National Bureau of Standards DES algorithm, but bro- 
ken in 4,096 different ways. Using the input key as key, a constant string is fed into the 
machine and recirculated a number of times. The 64 bits that come out are distributed into the 
66 output key bits in the result. 


Makekey is intended for programs that perform encryption (e.g., ed(1) and crypt(1)). Usually, 
its input and output will be pipes. 


SEE ALSO 
crypt(1), ed(1), passwd(5). 
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NAME 


MK(8). 


mk - how to remake the system and commands 


DESCRIPTION 
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All source for UNIX is in a source tree distributed in the directory /usr/sre. This includes source 
for the operating system, libraries, commands, miscellaneous files necessary to the running sys- 
tem, and procedures to create everything from this source. 


The top level consists of the directories cmd, lib, uts, head, and stand as well as commands to 
remake each of these “directories”. These commands are named :mk, which remakes every- 
thing, and :mkdir where dir is the directory to be recreated. Each recreation command will 
make all or part of the piec; over which it has control. :mk will run each of these commands and 
thus recreate the whole system. 


The lib directory contains libraries used when loading user programs. The largest. and most 
important of these is the C library. All libraries are in sub-directories and are created by a 
makefile or runcom. A runcom is a Shell command procedure used specifically to remake a 
piece of the system. :mklib will rebuild the libraries that are given as arguments. The argument 
\« will cause it to remake all libraries. 


The head directory contains the header files, usually found in /usr/include on the running sys- 
tem. :mkhead will install those header files that are given as arguments. The argument \+ will 
cause it to install all header files. 


The uts directory contains the source for the UNIX operating system. :mkuts (no arguments) 
invokes a series of makefiles that will recreate the operating system. _ 


The stand directory contains stand-alone commands and boot programs. :mkstand will rebuild 
and install these programs. 


The cmd directory contains files and directories. :mkcmd transforms source into a command 
based upon its suffix (.I, .y, .c, .s, .sh), or its makefile (see make(1)) or runcom. A directory is 
assumed to have a makefile or a runcom that will take care of creating everything associated 
with that directory and its sub-directories. Makefiles and runcoms are named command.mk 
and command.re respectively. 


:mkcmd will recreate commands based upon a makefile or runcom if one of them exists; alter- 
natively commands are recreated in a standard way based on the suffix of the source file. All 
commands requiring more than one file of source are grouped in sub-directories, and must have 
a makefile or a runcom. C programs (.c) are compiled by the C compiler and loaded stripped 
with shared text. Assembly language programs (.s) are run through the preprocessor of cc( - 
Pflag) and then assembled. The file Idflags in /usr/sre override the default flags to the loader, 
ld. This way, some commands can be loaded with the -i flag. Yacc programs (.y) and lex pro- 
grams (.I) are processed by yacc(1) and /ex(1) respectively before C compilation. Shell pro- 
grams (.sh) are copied to create the command. Each of these operations leaves a command in 
./emd which is then installed by using /etc/install. 


The arguments to :mkcmd are either command names, or subsystem names. The subsystems 
distributed with UNIX are: acct, graf, rje, sccs, and text. Prefacing the :mkcmd instruction with 
an assignment to the Shell variable $ARGS will cause the indicated components of the subsys- 
tem to be rebuilt. 


The entire sccs subsystem can be rebuilt by: 
/usr/src/:mkcmd sccs 

while the delta component of sccs can be rebuilt by: 
ARGS="delta" /usr/src/:mkcmd_ sccs 


The log command, which is a part of the stat package, which is itself a part of the graf pack- 
age, can be rebuilt by: 
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ARGS="stat log" /usr/src/:mkcmd graf 
The argument \+ will cause all commands and subsystems to be rebuilt. 


Makefiles, both in ./emd and in sub-directories, have a standard format. In particular :mkcmd 
depends on there being entries for install and clobber. Install should cause everything over 
which the makefile has jurisdiction to be made and installed by /etc/install. C/lobber should 
cause a complete cleanup of all unnecessary files resulting from the previous invocation. 


The file /etc/places defines several source and destination directories. 


Most of the runcoms in ./emd (as opposed to sub-directories) relate in particular to a need for 
separated instruction and data (! and D) space. 


In the past, dependency on the C library routine ctime(3C) was also important. Ctime had to be 
modified for all systems located outside of the Pacific time zone, and all commands that refer- 
enced it had to be recompiled. Ctime has been rewritten to check the environment (see 
environ(7)) for the time zone. This results in time zone conversions possible on a per-process 
basis. /etc/profile sets the initial environment for each user, and /etc/re sets it for certain sys- 
tem daemons. These two programs are the only ones which must be modified outside of the 
Pacific time zone. . 


An effort has been made to separate the creation of a command from source, and its installation 
on the running system. The command /etce/install is used by :mkcmd and most makefiles to 
install commands in the proper place on the running system. The use of install allows maximum 
flexibility in the administration of the system. Install makes very few assumptions about where a 
command is located, who owns it, and what modes are in effect. All assumptions may be over- 
ridden on invocation of the command, or more permanently by redefining a few variables in 
install. The object is to install a new version of a command in the same place, with the same 
attributes as the prior version. 


In addition, the use of a separate command to perform installation allows for the creation of test 
systems in other than standard places, easy movement of commands to balance load, and 
independent maintenance of makefiles. The minimization of makefiles in most cases, and the 
site independence of the others should greatly reduce the necessary maintenance, and allow 
makefiles to be considered part of the standard source. 


SEE ALSO 


install(1M), make(1). 
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NAME 





rc - system initialization shell script 
SYNOPSIS 
letc/re 


DESCRIPTION | 
The /ete/re file is executed by init(8) whenever the init state is changed. 


SEE ALSO 
init(8). 
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NAME 
rie - RJE (Remote Job Entry) to IBM 


SYNOPSIS 
/usr/rje/rjeinit 
/usr/rje/rjehalt 


DESCRIPTION 
RJE is the communal name for a collection of programs and a file organization that allows a 
UNIX system, equipped with an ICP driver, and associated Virtual Protocol Machine (VPM) 
software, to communicate with IBM’s Job Entry Subsystems by mimicking an IBM 360 remote 
multileaving work station. 





implementation. 

RJE is initiated by the command rpinit and is terminated gracefully by the command rphalt. 
While active, RJE runs in the background and requires no human supervision. It quietly 
transmits, to the IBM system, jobs that have been queued by the send(1C) command, and 
operator requests that have been entered by the rjestat(1C) command. It receives, from the IBM 
system, print and punch data sets and message output. It enters the data sets into the proper 
UNIX directory and notifies the appropriate user of their arrival. It scans the message output to 
maintain a record on each of its jobs. It also makes these messages available for public inspec- 
tion, so that rjestat(1C), in particular, may extract responses. 


Unless otherwise specified, all files and commands described below reside in directory /usr/rje 
(first exceptions: send and rpstat). 


There are two sources of data to be transmitted by RJE from UNIX to an IBM System/370. In 
both cases, the data is organized as files in the /usr/rje/squeue directory. The first are files 
named cos which are created by the enquiry command rjestat(1C). The second source, con- 
taining the bulk of the data, are files named rds« or sqs which have been created by send and 
queued by the program rjger. On completion of processing send invokes rjeqger. Rjyeqer and 
rjestat inform the program rjexmit that a file has been queued via the file joblog. Upon suc- 
cessful transmission of the data to the IBM machine, rjexmit removes the queued file. As files 
are transmitted and received, the program redisp writes an entry containing the date, time, file 
name, logname, and number of records in the file acctlog, if it exists. This file can be used for 
local logging or accounting information, but is not used elsewhere by RJE. The use of this infor- 
mation is up to the RJE administrator. 


Each time rpinit is invoked, the joblog file is truncated and recreated from the contents of the 
/usr/rje/squeue directory. During this time, rjeinit prevents simultaneous updating of the joblog 
file. 

Output from the IBM system is classified as either a print data set, a punch data set, or message 
output. Print output is converted to an ASCIl text file, with standard tabs. Form feeds are 
suppressed, but the last line of each page is distinguished by the presence of an extraneous 
trailing space. Punch output is converted to pnch(5) format. This classification and both 
conversions occur as the output is received. Files are moved or copied into the appropriate 
user's directory and assigned the name prnts or pnchs, respectively, or placed into user direc- 
tories under user-specified names, or used as input to programs to be automatically executed, 
as specified by the user. This process is driven by the “usr=...” specification. RJE retains own- 
ership of these files and permits read-only access to them. Message output is digested by RJE 
immediately and is not retained. 


A record is maintained for each job that passes through RJE. Identifying information is extracted 
contextually from files transmitted to and received from the IBM system. This information is 
stored and used by the rjedisp program for IBM job acknowledgements and delivery of output 
files. 
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The IBM system automatically returns an acknowledgement message for each job it receives. 
Other status messages are returned in response to enquiries entered by users. All messages 
received by RJE are appended to the resp file. The resp file is automatically truncated when it 
reaches 70,000 bytes. Each enquiry is preceded and followed by an identification card image of 
the form “$UX < process id>"”. The IBM system will echo this back as an illegal command. The 
appearance of process ids in the response stream permits responses to be passed on to the 
proper users. 


While it is active, RJE occupies at least the three process slots that are appropriated by rpinit. 
These slots are used to run rexmit, the transmitter, rerecv, the receiver, and redisp, the 
dispatcher. These three processes are connected by pipes. The function of each is as follows: 





rjexmit Cycles repetitively, looking for data to transmit to the IBM system. After transmission, 
rjexmit passes an event notice to rjedisp. \f rexmit encounters a stop file, (created by 
rjehalt), it exits normally. In the case of error termination, rfexmit reboots RJE by exe- 
cuting rpinit. 

rjerecv Cycles repetitively, looking for data returning from the IBM machine. Upon receipt of 
data, rjerecv notifies either rexmit or redisp of the event (transfer information is some- 
times passed to rjexmit). Ryerecv exits normally at the first appropriate moment when it 
encounters the file stop, or exits reluctantly when it encounters a run of errors. 


rjedisp Follows up event notices by directing output files, updating records, and notifying users. 
Riedisp references the system files /etc/passwd and /etc/utmp to correlate user 
names, numeric ids, and terminals. Termination of rferecv causes redisp to exit also. 


Most RJE files and directories are protected from unauthorized tampering. The exception is the 
spool directory. It is used by send(1C) to create temporary files in the correct file system. 
Rieger and rjestat(1C), the user's interfaces to RJE, operate in setuid mode to contribute the 
necessary permission modes. 





Administration. 
Some minimal oversight of each RJE subsystem is required. The RJE mailbox should be 
inspected and cleaned out periodically. The job directory should also be checked. The only 
files placed there are output files whose destination file systems are out of space. Users should 
be given a short period of time (say, a day or two), and then these files should be removed. 


The configuration table /usr/rje/lines is accessed by all components of RJE. Each line of the 
table (maximum of 8) defines an RJE connection. Its seven columns may be labeled host, sys- 
tem, directory, prefix, device, peripherals and parameters. These columns are described as 
follows: 


host 
The name of a remote IBM computer (e.g., A B C). This string can be up to 5 charac- 
ters. 
system 
The name of a UNIX system. This name should be the same as the system name from 
uname (1). 
directory 
This is the directory name of the servicing RJE subsystem (e.g., /usr/rje1). 
prefix 
This is the string prefixed (redundantly) to several crucial files and programs in direc- 
tory (e.g., rje1, rje2, rje3). 
device | 
This is the name of the controlling VPM device, with /dev/ excised. 
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_ peripherals 
This field contains information on the logical devices (readers, printers, punches) used 
by RJE. Each subfield is separated by :, and is described as follows: 


(1) Number of logical readers. 
(2) Number of logical printers. 
(3) Number of logical punches. 


Note: the number of peripherals specified for an RJE subsystem must agree with the 
number of peripherals which have been described on the remote machine for that line. 


parameters 
This field contains information on the type of connection to make. Each subfield is 
separated by :. Any or all fields may be omitted; however, the fields are positional. All 
but trailing delimiters must be present. For example, in 
1200:512:::9-555-1212 
subfields 3 and 4 are missing, but the delimiters are present. Each subfield is defined 
as follows: : 


(1) space 

This subfield specifies the amount of space (S) in blocks that RJE tries to main- 
tain on file systems it touches. The default is 0 blocks. Send will not submit 
jobs and rpinit issues a warning when less than 1.5S blocks are available; 
rjerecv stops accepting output from the host when the capacity falls to S blocks; 
RJE becomes dormant, until conditions improve. If the space on the file system 
specified by the user on the “usr=" card would be depleted to a point below S, 
the file will be put in the job subdirectory of the connection’s home directory, 
rather than in the place that the user requested. 


(2) size 
This subfield specifies the size in blocks of the largest file that can be accepted 
from the host without truncation taking place. The default is no truncation. 


(3) badjobs 
This subfield specifies what to do with undeliverable returning jobs. If an output 
file is undeliverable for any reason other than file system space limitations (e.g., 
missing or invalid “usr=" card) and this subfield contains the letter y, the output 
will be retained in the job subdirectory of the home directory, and login rje is 
notified. If this subfield contains an n or has any other value, undeliverable out- 
put will be discarded. The default is n. 


(4) console 
This subfield specifies the status of the interactive status terminal for this line. If 
the subfield contains an i, all console status facilities are inhibited (e.g., 
rjestat(1C) will not behave like a status terminal). In all cases, the normal non- 
interactive uses of rjestat(1C) will continue to function. The default is y. 


Sign-on is controlled by the existence of a | 
signon file in the home directory. If this file is present, its contents are sent as a sign- 
on message to the host system. If this file does not exist, a blank card is sent. Sign-off 
is controlled in the same way, except that the signoff file is sent by rjehalt if it exists. If 
the signoff file does not exist, a “/ssignoff” card is sent. These files should be ASCil 
text and no more than 80 characters. 


Send(1C) and rjestat(1C) select an available connection by indexing on the host field of the 
configuration table. RJE programs index on the prefix field. A subordinate directory, sque, 
exists in /usr/rje for use by rjedisp and shqer programs. This directory holds those output files 
that have been designated as standard input to some executable file. This designation is done 
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via the “usr=..." specification. Riedisp places the output files here and updates the file log to 


specify the order of execution, arguments to be passed, etc. Shqger executes the appropriate 
files. 





All RJE programs are shared text; therefore, if more than one RJE is to be run on a given UNIX 
system, simply link (via /n(1)) RJE2 program names to RJE names in /usr. 
SEE ALSO 
rjestat(1C), send(1C), vpm(4), pnch(5), mk(8). 
UNIX Remote Job Entry User's Guide by K. A. Kelleman. 


UNIX Remote Job Entry Administrative Guide by M. J. Fitton. 
Setting Up UNIX. 


DIAGNOSTICS 


Ryeinit provides brief error messages describing obstacles encountered while bringing up RJE. 
They can best be understood in the context of the RJE source code. The most frequently occur- 
ring one is “cannot open /dev/vpm?”. This may occur if the VPM script has not been started, or 
if another process already has the VPM device open. 


Once RJE has been started, users should assist in monitoring its performance, and should notify 
operations personnel of any perceived need for remedial action. Rjestat(1C) will aid in diagnos- 
ing the current state of RJE. It can detect, with some reliability, when the far end of the com- 
munications line has gone dead, and will report in this case that the host computer is not 


responding to RJE. It will also attempt to reboot RJE if it detects a prolonged period of inactivity 
on the ICP. 
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SAR(8) SAR(8). . 


NAME 





sar - system activity report package 


DESCRIPTION 
Sar is the first (tentative) piece of an overall UNIX measurement and statistics package; the data 
that are collected and the output formats are not yet final. 


The operating system contains a number of counters that are incremented as various system 
actions occur. These include several time counters (that are incremented each 50th of a second 
depending on the CPU mode), VO activity counters, switching and system-call counters, and 
file-access counters. The system activity package writes system activity parameters periodi- 
cally on a binary file. It also generates a daily system activity report that covers the prime 
period (from 8:00 to 18:00). 


The data collection and report generation are controlled by entries in crontab (see cron(1M)). 
The data collection program is normally activated every hour on the hour; the report generation 
once a day. 


Every time the system is booted, a special record is written to the daily data file, since all the 
system activity counters restart from zero at that time. This process is done while executing 
letc/re see (init(8)) during UNIX initialization. It produces an entry on the daily report showing 
the restart time. 


The daily reports are deposited in /usr/adm/sa/sardd where dd are digits representing the day 
of the month. A report can be printed (e.g., cat /usr/adm/sa/sar05) any time before it is 
removed the following week. 


The structure of the binary daily data file is: 





struct sa { 
struct sysinfo si; /« defined in /usr/include/sys/sysinfo.h +/ 
long dO; /* number of reads and writes of disk 0 +/ 
long d1; /* number of reads and writes of disk 1 +/ 
long d2; /* number of reads and writes of disk 2 +/ 
long ts; /x time stamp in time_t format +/ 
}; 
FILES 
/usr/adm/sa/sadd daily data file 
/ust/adm/sa/sardd daily report file 
/tmp/sa.adrfl address file 
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SHUTDOWN (8) SHUTDOWN(8). . 


NAME 





shutdown - terminate all processing 


SYNOPSIS 
/etc/shutdown 


DESCRIPTION 
Shutdown is part of the UNIX operation procedures. Its primary function is to terminate all 
currently running processes in an orderly and cautious manner. The procedure is designed to 
interact with the operator (i.e., the person who invoked shutdown). Shutdown may instruct the 
operator to perform some specific tasks, or to supply certain responses before execution can 
resume. Shutdown should be run from the system console by root. 


Shutdown goes through the following steps: 


- All users logged on the system are notified to log off the system by a broadcasted message. 
The operator may display his/her own message at this time. Otherwise, the standard file 
save message is displayed. 


- f the operator wishes to run the file-save procedure, shutdown unmounts all file systems. 


- All file systems’ super blocks are updated before the system is to be stopped (see 
sync(1M)). This must be done before re-booting the system, to insure file system integrity. 


Shutdown does not terminate processes associated with the operator's terminal. The most 
common error diagnostic that will occur is device busy. This diagnostic happens when a partic- 
ular file system could not be unmounted. See umount(1M). 


SEE ALSO 
sync(1M), umount(1M). 

















